Compartir a través de


Cómo: Crear plantillas de elementos de varios archivos

Actualización: noviembre 2007

Las plantillas de elementos sólo pueden especificar uno elemento, pero a veces el elemento se compone de varios archivos. Por ejemplo, las plantillas de elementos de los formularios Windows Forms requieren 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 utilizan las extensiones 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. El procedimiento siguiente explica cómo utilizar los parámetros para garantizar que se crean las extensiones de archivo correctas.

Para crear manualmente una plantilla de elementos de varios archivos

  1. 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 manualmente.

  2. Agregue los atributos TargetFileName a cada uno de los elementos ProjectItem. Establezca el valor de los atributos TargetFileName en $fileinputname$.FileExtension, donde FileExtension es la extensión 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 basarán en el nombre del usuario especificado en el cuadro de diálogo Agregar nuevo elemento.

  3. Seleccione los archivos incluidos en la plantilla, haga clic con el botón secundario, elija Enviar a y haga clic en la carpeta comprimida (ZIP). Los archivos seleccionados se comprimen en un archivo .zip.

  4. Coloque el archivo .zip en la ubicación de la plantilla de elementos de usuario. De manera predeterminada, el directorio es \Mis documentos\Visual Studio 2008\Templates\ItemTemplates\. Para obtener más información, vea Cómo: Localizar y organizar plantillas de proyectos y de elementos.

Ejemplo

El ejemplo siguiente muestra una plantilla de formulario Windows Forms de Visual Studio. Cuando se crea un elemento basado en esta plantilla, el nombre de los tres archivos creados coincidirá 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: Crear plantillas de elementos manualmente

Cómo: Sustituir parámetros en una plantilla

Conceptos

Parámetros de plantilla

Otros recursos

Crear plantillas de elementos