Cómo: Crear plantillas de elementos de varios archivos

Artículo
06/10/2015

Las plantillas de elementos sólo pueden especificar uno elemento, pero a veces el elemento se compone de varios archivos.Por ejemplo, una plantilla de elemento de formularios Windows Forms para Visual Basic requiere los tres archivos siguientes:

Un archivo .vb que contiene el código del formulario.
Un archivo .vb que contiene la información del diseñador del formulario.
Un archivo .resx que contiene los recursos incrustados del formulario.

Las plantillas de elementos de varios archivos requieren el uso de parámetros para garantizar que se usan las extensiones de nombre de archivo correctas cuando se crea el elemento en Visual Studio.Si crea una plantilla de elementos mediante el Asistente para exportar plantillas, se generarán estos parámetros automáticamente y no hará falta ninguna edición adicional.En los pasos siguientes se explica cómo usar los parámetros para garantizar que se crean las extensiones de nombre de archivo correctas.

Para crear manualmente una plantilla de elementos de varios archivos

Cree la plantilla de elementos de la misma manera que lo haría con una plantilla de elementos de un único archivo.Para obtener más información, vea Cómo: Crear plantillas de elementos.
Agregue atributos TargetFileName a cada elemento ProjectItem.Establezca los valores de los atributos TargetFileName en $fileinputname$.extensiónDeArchivo, donde extensiónDeArchivo es la extensión de nombre de archivo del archivo que se incluye en la plantilla.Por ejemplo:
```
<ProjectItem TargetFileName="$fileinputname$.vb">
    Form1.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.Designer.vb">
    Form1.Designer.vb
</ProjectItem>
<ProjectItem TargetFileName="$fileinputname$.resx">
    Form1.resx
</ProjectItem>
```
Cuando se agrega a un proyecto un elemento procedente de esta plantilla, los nombres de archivo se basan en el nombre que el usuario escribió en el cuadro de diálogo Agregar nuevo elemento.
Seleccione los archivos que se van a incluir en la plantilla, haga clic con el botón secundario del mouse en la selección, haga clic en Enviar a y, a continuación, haga clic en Carpeta comprimida (en zip).Los archivos seleccionados se comprimen en un archivo .zip.
Coloque el archivo .zip en la ubicación de la plantilla de elementos de usuario.de forma predeterminada, el directorio es \My Documents\Visual Studio Versión\Templates\ItemTemplates \.Para obtener más información, vea Cómo: Localizar y organizar plantillas de proyectos y de elementos.

Ejemplo

En el ejemplo siguiente se muestra una plantilla de Windows Forms de Visual Studio.Cuando se crea un elemento basado en esta plantilla, los nombres de los tres archivos creados coincidirán con el nombre especificado en el cuadro de diálogo Agregar nuevo elemento.

<VSTemplate Version="2.0.0" Type="Item"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-file Item Template</Name>
        <Icon>Icon.ico</Icon>
        <Description>An example of a multi-file item template</Description>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectItem TargetFileName="$fileinputname$.vb" SubType="Form">
            Form1.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.Designer.vb">
            Form1.Designer.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.resx">
            Form1.resx
        </ProjectItem>
    </TemplateContent>
</VSTemplate>

Vea también

Tareas

Cómo: Crear plantillas de elementos

Cómo: Sustituir parámetros en una plantilla

Conceptos

Crear plantillas para proyectos y elementos en Visual Studio

Parámetros de plantilla

Compartir a través de