Compartir a través de


Crear plantillas de elemento de varios archivos

Puede que las plantillas de elementos solo especifiquen un elemento, pero a veces el elemento se compone de varios archivos. Por ejemplo, una plantilla de elemento de Windows Forms requiere los tres archivos siguientes:

  • Un archivo que contiene el código del formulario.

  • Un archivo que contiene la información del diseñador para el formulario.

  • Un archivo que contiene los recursos incrustados del formulario.

Las plantillas de elementos de varios archivos requieren parámetros para garantizar que se usan las extensiones de archivo correctas cuando se crea el elemento. Si crea una plantilla de elemento de varios archivos mediante el Asistente para exportar plantillas, estos parámetros se generan automáticamente y no se requiere ninguna otra edición.

Uso del Asistente para exportar plantillas

Puede crear una plantilla de elementos de varios archivos igual que una plantilla de elemento de archivo único. Vea Cómo: Crear plantillas de elemento. En la página Seleccionar elemento para exportar del asistente, seleccione el archivo que tiene archivos dependientes (por ejemplo, un archivo de formulario de Windows Forms). El asistente incluye automáticamente en la plantilla los archivos dependientes, como el diseñador y los archivos de recursos.

Creación manual de una plantilla de elemento de varios archivos

  1. Cree la plantilla de elemento igual que lo haría para crear una plantilla de elemento de archivo único, pero incluya cada archivo que compone el elemento de varios archivos.

  2. En el archivo XML .vstemplate, agregue un elemento ProjectItem para cada archivo y, después, agregue un atributo TargetFileName a dicho elemento. Establezca el valor del atributo TargetFileName en $fileinputname$.FileExtension, donde FileExtension es la extensión 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>
    

    Nota

    Cuando se agrega un elemento derivado de esta plantilla a un proyecto, los nombres de archivo derivarán del nombre que el usuario escriba en el cuadro de diálogo Agregar nuevo elemento.

  3. Seleccione los archivos que se incluirán 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.

  4. Copie el archivo .zip en la ubicación de la plantilla de elemento del usuario. De forma predeterminada, el directorio es %USERPROFILE%\Documentos\Visual Studio <versión>\Templates\ItemTemplates. Para obtener más información, vea Cómo: Localizar y organizar plantillas.

  5. Cierre Visual Studio y vuelva a abrirlo.

  6. 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 de varios archivos aparece en el cuadro de diálogo Agregar nuevo elemento.

Ejemplo

En el ejemplo siguiente se muestra una plantilla de Windows Forms. 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="http://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>