Cómo: Crear plantillas de varios proyectos

Artículo
10/07/2008

Actualización: noviembre 2007

Las plantillas de varios proyectos actúan como contenedores para los dos o más proyectos. Cuando se crea un proyecto basado en una plantilla de varios proyectos desde el cuadro de diálogo Nuevo proyecto, todos los proyectos incluidos en la plantilla se agregan a la solución.

Una plantilla de varios proyectos debe incluir los elementos siguientes, comprimidos en un solo archivo .zip:

Un archivo .vstemplate raíz para la plantilla de varios proyectos completa. Este archivo .vstemplate raíz contiene los metadatos que se muestran en el cuadro de diálogo Nuevo proyecto y especifica dónde encontrar los archivos .vstemplate de los proyectos de la plantilla. Este archivo debe estar en la raíz del archivo .zip.
Una o más carpetas que contienen los archivos necesarios para una plantilla de proyecto completa. Esto incluye todos los archivos de código y un archivo .vstemplate para el proyecto.

Por ejemplo, un archivo .zip de plantilla de varios proyectos con dos proyectos podría tener los archivos y directorios siguientes:

MultiProjectTemplate.vstemplate

\Project1\Project1.vstemplate

\Project1\Project1.vbproj

\Project1\Class.vb

\Project2\Project2.vstemplate

\Project2\Project2.vbproj

\Project2\Class.vb

El archivo .vstemplate raíz de una plantilla de varios proyectos se diferencia del de una plantilla de un solo proyecto en lo siguiente:

El atributo Type del elemento VSTemplate contiene el valor ProjectGroup. Por ejemplo:

<VSTemplate Version="2.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">

El elemento TemplateContent contiene un elemento ProjectCollection con uno o varios elementos ProjectTemplateLink que definen las rutas de acceso a los archivos .vstemplate de los proyectos incluidos. Por ejemplo:

<TemplateContent>
    <ProjectCollection>
        <ProjectTemplateLink>
            Project1\Project1.vstemplate
        </ProjectTemplateLink>
        <ProjectTemplateLink>
            Project2\Project2.vstemplate
        </ProjectTemplateLink>
    </ProjectCollection>
</TemplateContent>

Las plantillas de varios proyectos también se comportan de manera diferente que las normales. Las plantillas de varios proyectos tienen las siguientes características específicas:

No se puede asignar nombres a los proyectos individuales de una plantilla de varios proyectos desde el cuadro de diálogo Nuevo proyecto. En su lugar, utilice el atributo ProjectName del elemento ProjectTemplateLink para especificar el nombre de cada proyecto. Para obtener más información, vea el primer ejemplo de la sección siguiente.
Las plantillas de varios proyectos pueden contener proyectos escritos en distintos lenguajes, pero la plantilla completa propiamente dicha sólo se puede colocar en una categoría con el elemento ProjectType.

Para crear una plantilla de varios proyectos

Cree los proyectos que desee incluir en la plantilla de varios proyectos.
Cree los archivos .vstemplate correspondientes a cada uno de los proyectos. Para obtener más información, vea Cómo: Crear plantillas de proyectos y Cómo: Crear plantillas de proyecto manualmente.
Cree un archivo .vstemplate raíz, que contendrá los metadatos de la plantilla de varios proyectos. Para obtener más información, vea el primer ejemplo de la sección siguiente.
Seleccione los archivos y las carpetas incluidos en la plantilla, haga clic con el botón secundario del mouse, seleccione Enviar a y haga clic en Carpeta comprimida (en zip). Los archivos y las carpetas se comprimen en un archivo .zip.
Coloque el archivo de plantilla .zip en el directorio de plantillas de proyecto de Visual Studio. De manera predeterminada, este directorio es Mis documentos\Visual Studio 2008\Templates\ProjectTemplates.

Ejemplo

Este ejemplo muestra un archivo .vstemplate raíz sencillo de plantilla de varios proyectos. En este ejemplo, el programa contiene dos proyectos, My Windows Application y My Class Library. El atributo ProjectName del elemento ProjectTemplateLink establece el nombre que Visual Studio debe asignar a este proyecto. Si el atributo ProjectName no existe, se utiliza el nombre del archivo .vstemplate como nombre del proyecto.

<VSTemplate Version="2.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-Project Template Sample</Name>
        <Description>An example of a multi-project template</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectCollection>
            <ProjectTemplateLink ProjectName="My Windows Application">
                WindowsApp\MyTemplate.vstemplate
            </ProjectTemplateLink>
            <ProjectTemplateLink ProjectName="My Class Library">
                ClassLib\MyTemplate.vstemplate
            </ProjectTemplateLink>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

Este ejemplo utiliza el elemento SolutionFolder para dividir los proyectos en dos grupos, Math Classes y Graphics Classes. La plantilla contiene cuatro proyectos, dos de los cuales se encuentran en cada carpeta de soluciones.

<VSTemplate Version="2.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-Project Template Sample</Name>
        <Description>An example of a multi-project template</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectCollection>
            <SolutionFolder Name="Math Classes">
                <ProjectTemplateLink ProjectName="MathClassLib1">
                    MathClassLib1\MyTemplate.vstemplate
                </ProjectTemplateLink>
                <ProjectTemplateLink ProjectName="MathClassLib2">
                    MathClassLib2\MyTemplate.vstemplate
                </ProjectTemplateLink>
            </SolutionFolder>
            <SolutionFolder Name="Graphics Classes">
                <ProjectTemplateLink ProjectName="GraphicsClassLib1">
                    GraphicsClassLib1\MyTemplate.vstemplate
                </ProjectTemplateLink>
                <ProjectTemplateLink ProjectName="GraphicsClassLib2">
                    GraphicsClassLib2\MyTemplate.vstemplate
                </ProjectTemplateLink>
            </SolutionFolder>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

Vea también

Compartir a través de

Cómo: Crear plantillas de varios proyectos

Para crear una plantilla de varios proyectos

Ejemplo

Vea también

Tareas

Referencia

Otros recursos

Recursos adicionales