Crear plantillas de elemento
En este tema se muestra cómo crear una plantilla de elemento con el Asistente para exportar plantillas. Si la plantilla consta de varios archivos, vea Cómo: Crear plantillas de elementos de varios archivos.
Incorporación de una plantilla de elemento al cuadro de diálogo Agregar nuevo elemento
Cree o abra un proyecto en Visual Studio.
Agregue un elemento al proyecto y, si quiere, modifíquelo.
Modifique el archivo de código para indicar dónde debe aplicarse el reemplazo de parámetros. Para obtener más información, vea Cómo: Sustituir parámetros en una plantilla.
En el menú Proyecto, elija Exportar plantilla.
En la página Elegir tipo de plantilla, seleccione Plantilla de elemento, seleccione el proyecto que contiene el elemento y seleccione Siguiente.
En la página Seleccionar elemento para exportar, seleccione el elemento para el que quiera crear una plantilla y seleccione Siguiente.
En la página Seleccionar referencias de elemento, seleccione las referencias de ensamblado que quiera incluir en la plantilla y seleccione Siguiente.
En la página Seleccionar opciones de plantilla, indique el nombre de esta y una descripción opcional, una imagen de icono, una imagen de vista previa y seleccione Finalizar. Los archivos de icono de los elementos son archivos
.ico, como se describe en Imágenes e iconos para Visual Studio: tipos de archivo. La imagen de vista previa es una imagen de 200 x 200 que aparecerá en el cuadro de diálogo Agregar nuevo elemento.Puede buscar en la biblioteca de imágenes de Visual Studio iconos coherentes con el estilo de Visual Studio.
Los archivos de la plantilla se agregan a un archivo .zip y se copian en el directorio especificado en el asistente. La ubicación predeterminada es %USERPROFILE%\Documentos\Visual Studio <versión>\My Exported Templates.
Si no ha seleccionado la opción Importar la plantilla automáticamente en Visual Studio del Asistente para exportar plantillas, busque la plantilla exportada. A continuación, cópiela en el directorio de plantillas de elemento de usuario. La ubicación predeterminada es %USERPROFILE%\Documentos\Visual Studio <versión>\Templates\ItemTemplates.
Cierre Visual Studio y vuelva a abrirlo.
Cree un proyecto o bien abra uno existente y, después, elija Proyecto>Agregar nuevo elemento, o bien pulse Ctrl+Mayús+A.
La plantilla de elemento aparece en el cuadro de diálogo Agregar nuevo elemento. Si ha agregado una descripción en el Asistente para exportar plantillas, la descripción aparecerá en la parte derecha del cuadro de diálogo.
Habilitación del uso de plantillas de elemento en un proyecto de aplicación Windows universal
El asistente hace gran parte del trabajo de creación de una plantilla básica, pero en muchos casos deberá modificar manualmente el archivo .vstemplate después de haber exportado la plantilla. Por ejemplo, si quiere que el elemento aparezca en el cuadro de diálogo Agregar nuevo elemento de un proyecto de Aplicación universal de Windows, tendrá que efectuar unos pasos adicionales.
Siga los pasos de la sección anterior para exportar una plantilla de elemento.
Extraiga el archivo .zip creado y abra el archivo .vstemplate en Visual Studio.
Para un proyecto de C# de Windows universal, agregue el siguiente XML en el elemento
<TemplateData>:<TemplateID>Microsoft.CSharp.Class</TemplateID>En Visual Studio, guarde el archivo .vstemplate y ciérrelo.
Copie y pegue el archivo .vstemplate en el archivo .zip.
Si aparece el cuadro de diálogo Copiar archivo, elija la opción Copiar y reemplazar.
Ahora puede agregar un elemento basado en esta plantilla a un proyecto de Windows universal desde el cuadro de diálogo Agregar nuevo elemento.
Habilitación de plantillas para subtipos de proyecto específicos
Puede especificar que la plantilla solo debería aparecer para determinados subtipos de proyecto, como Windows, Office, base de datos o web.
Busque el elemento
ProjectTypeen el archivo .vstemplate de la plantilla de elementos.Agregue un elemento ProjectSubType inmediatamente después del elemento
ProjectType.Establezca el valor de texto del elemento en uno de los siguientes valores:
- Windows
- Office
- Base de datos
- Web
Por ejemplo: <ProjectSubType>Database</ProjectSubType>.
En el ejemplo siguiente se muestra una plantilla de elementos para los proyectos de Office.
<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
<TemplateData>
<Name>Class</Name>
<Description>An empty class file</Description>
<Icon>Class.ico</Icon>
<ProjectType>CSharp</ProjectType>
<ProjectSubType>Office</ProjectSubType>
<DefaultName>Class.cs</DefaultName>
</TemplateData>
<TemplateContent>
<ProjectItem>Class1.cs</ProjectItem>
</TemplateContent>
</VSTemplate>
Creación manual de una plantilla de elemento
En algunos casos es posible que quiera crear una plantilla de elementos manualmente desde cero.
Cree un proyecto y un elemento de proyecto.
Modifique el elemento de proyecto hasta que se pueda guardar como plantilla.
Modifique el archivo de código para indicar dónde debe aplicarse el reemplazo de parámetros, si se debe aplicar alguno. Para obtener más información sobre el reemplazo de parámetros, vea Cómo: Sustituir parámetros en una plantilla.
Cree un archivo XML y guárdelo con la extensión de archivo .vstemplate en el mismo directorio del archivo de elemento de proyecto.
Edite el archivo XML .vstemplate para proporcionar los metadatos de la plantilla de elementos. Para obtener más información, vea Referencia de esquema de plantilla de Visual Studio (Extensibilidad) y el ejemplo de la sección anterior.
Guarde el archivo .vstemplate y ciérrelo.
En el Explorador de Windows, seleccione los archivos que quiere incluir en la plantilla. Haga clic con el botón derecho en la selección y elija Enviar a>Carpeta comprimida (en zip) . Los archivos seleccionados se comprimen en un archivo .zip.
Copie el archivo .zip y péguelo en la ubicación de la plantilla de elementos del usuario. El directorio predeterminado es %USERPROFILE%\Documents\Visual Studio 2022\Templates\ItemTemplates. Para obtener más información, vea Cómo: Buscar y organizar plantillas de proyecto y elemento.