Elemento Project (plantillas de Visual Studio)

Artículo
01/13/2024

Especifica los archivos o directorios que se van a agregar al proyecto.

Sintaxis

<Project
    File="MyProject.proj"
    TargetFileName="MyTargetProject.proj"
    ReplaceParameters="true/false">
    IgnoreProjectParameter="$myCustomParameter$"
        ...
</Project>

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
`File`	Atributo necesario. Especifica el nombre del archivo de proyecto en la plantilla .zip archivo.
`ReplaceParameters`	Atributo opcional. Valor booleano que especifica si el archivo de proyecto tiene valores de parámetro que se deben reemplazar cuando se crea un proyecto a partir de la plantilla. El valor predeterminado es `false`.
`TargetFileName`	Atributo opcional. Especifica el nombre del archivo de proyecto cuando se crea un proyecto a partir de la plantilla.
`IgnoreProjectParameter`	Atributo opcional. Especifica si el proyecto se debe agregar a la solución actual. Si el valor del parámetro personalizado, "$myCustomParameter$" existe en el archivo de reemplazo de parámetros, el proyecto se crea pero no se agrega como parte de la solución abierta actualmente.

Elementos secundarios

Elemento	Descripción
Carpeta	Elemento opcional. Especifica una carpeta que se va a agregar al proyecto.
ProjectItem	Elemento opcional. Especifica un archivo que se va a agregar a un proyecto.

Elementos primarios

Elemento	Descripción
TemplateContent	Elemento necesario.

Comentarios

Project es un elemento secundario opcional de TemplateContent.

El Project elemento se usa para especificar un proyecto y, por tanto, solo es válido en las plantillas de proyecto.

Project Los elementos pueden tener elementos secundarios Folder o elementos secundarios ProjectItem , pero no una mezcla de elementos secundarios Folder y ProjectItem .

Visual Studio cambia automáticamente el nombre del archivo del proyecto en función del nombre especificado por el usuario en el cuadro de diálogo Nuevo proyecto . Use el TargetFileName atributo si desea proporcionar un nombre de archivo alternativo para los archivos de proyecto creados con la plantilla.

Ejemplo

El ejemplo siguiente muestra los metadatos de una plantilla de proyecto para una aplicación Visual C#.

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>