Creación de plantillas de elemento

En este artículo se muestra cómo crear una plantilla de artículo mediante el Asistente para exportar plantillas o manualmente, y cómo editar y usar plantillas de artículo. Si la plantilla consta de varios archivos, vea también Cómo: Crear plantillas de elementos de varios archivos.

Agregar una plantilla de artículo

1. Cree o abra un proyecto en Visual Studio.

2. Seleccione Proyecto>Agregar nuevo elemento o presione Ctrl+Mayús+A.

3. En el cuadro de diálogo Agregar nuevo elemento , seleccione un elemento y, a continuación, seleccione Agregar para agregarlo al proyecto.

4. Modifique el elemento como desee e indique en qué parte del elemento, si es que se debe realizar el reemplazo de parámetros. Para obtener más información, vea Cómo: Sustituir parámetros en una plantilla.

5. Guarde el elemento.

6. SeleccionePlantilla de exportación deproyecto>. Se abre el Asistente para exportar plantillas .

7. En la página Elegir tipo de plantilla , elija Plantilla de elemento, seleccione el proyecto que contiene el elemento y, a continuación, seleccione Siguiente.

8. En la página Seleccionar elemento para exportar , elija el elemento para el que desea crear una plantilla y, a continuación, seleccione Siguiente.

9. En la página Seleccionar referencias de artículo , seleccione las referencias de ensamblado que desee incluir en la plantilla y, a continuación, seleccione Siguiente.

10. En la página Seleccionar opciones de plantilla :

    • Introduzca el nombre de la plantilla y la descripción opcional, la imagen del icono y la imagen de vista previa.

      Los archivos de iconos de los elementos son archivos .ico , tal y como se describe en Imágenes e iconos de Visual Studio. La imagen de vista previa es una imagen de 200 x 200 que aparece en el cuadro de diálogo Agregar nuevo elemento . Puede descargar la biblioteca de imágenes de Visual Studio para obtener iconos coherentes con el estilo de Visual Studio.

    • Seleccione si desea importar automáticamente la plantilla en Visual Studio y mostrar una ventana del explorador en la carpeta de archivos de salida.

11. Selecciona Finalizar.

Los archivos de plantilla se comprimen en un archivo .zip y se copian en el directorio que se muestra en el asistente en Ubicación de salida. La ubicación predeterminada es %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

Si seleccionó Importar automáticamente la plantilla en Visual Studio, el archivo .zip también se agrega al directorio ItemTemplates del usuario. La ubicación predeterminada es %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Ahora puede utilizar la plantilla de elemento en sus proyectos.

Usar la plantilla de artículo

1. Si no seleccionó Importar automáticamente la plantilla en Visual Studio al crear la plantilla, copie el archivo .zip en el directorio ItemTemplates . La ubicación predeterminada es %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
2. Cierre Visual Studio y, a continuación, vuelva a abrirlo.
3. Cree un nuevo proyecto o abra un proyecto existente y seleccione Proyecto>Agregar nuevo elemento
4. Seleccione la plantilla de artículo en el cuadro de diálogo Agregar nuevo elemento . Si ha agregado una descripción en el Asistente para exportar plantillas, la descripción aparece en el lado derecho del cuadro de diálogo.
5. Seleccione Agregar para agregar el elemento de plantilla al proyecto.

Editar el archivo .vstemplate

El asistente crea una plantilla básica, pero en algunos casos es necesario modificar manualmente el archivo .vstemplate después de exportar la plantilla. Por ejemplo, si desea que el elemento aparezca en el cuadro de diálogo Agregar nuevo elemento para un proyecto de Aplicación universal de Windows, debe editar el archivo .vstemplate .

1. Extraiga el archivo de.zip plantilla de elemento exportado y abra el archivo .vstemplate en Visual Studio.
2. Edite el archivo según sea necesario. En el caso de un proyecto de Windows universal de C#, agregue <TemplateID>Microsoft.CSharp.Class</TemplateID> dentro del <TemplateData> elemento.
3. Guarde y cierre el archivo .vstemplate y reemplácelo en el archivo .zip .

Habilitar plantillas para subtipos de proyectos específicos

Puede editar el archivo .vstemplate para especificar que la plantilla de elemento solo aparezca para determinados subtipos de proyecto, como Windows, Office, Base de datos o Web.

1. Abra el archivo .vstemplate para editarlo.
2. Agregue un elemento ProjectSubType inmediatamente después del elemento, con el ProjectType valor Windows, Office, Database, o Web. Por ejemplo: <ProjectSubType>Database</ProjectSubType>.

En el ejemplo siguiente se muestra un archivo .vstemplate para Office proyectos.

<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>

Crear manualmente una plantilla de artículo

En lugar de utilizar el asistente, puede crear una plantilla de artículo manualmente desde cero.

1. Cree un proyecto y agregue un elemento.
2. Modifique el elemento como desee, por ejemplo, agregando dónde debe tener lugar cualquier reemplazo de parámetros, y guarde el elemento.
3. Cree un archivo XML y guárdelo con una extensión de archivo .vstemplate en el mismo directorio que el archivo de elementos del proyecto.
4. Agregue metadatos de plantilla de elemento al archivo XML .vstemplate , como se muestra en el ejemplo anterior. Para obtener más información, consulte Referencia de esquema de plantilla (extensibilidad).
5. Guarde y cierre el archivo .vstemplate .
6. En el Explorador de Windows, seleccione los archivos que desea incluir en la plantilla, incluido el archivo .vstemplate . Haga clic con el botón derecho en la selección y seleccione Comprimir al>archivo ZIP.
7. Copie el archivo de.zip resultante y péguelo en la ubicación de la plantilla de elemento de usuario de Visual Studio. El directorio predeterminado es %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Contenido relacionado

• Localice y organice plantillas de proyectos y elementos
• Crear plantillas de proyecto y elemento
• Crear plantillas de elementos de varios archivos
• Referencia de esquema de plantilla de Visual Studio (extensibilidad)