Elemento Folder (plantillas de proyecto de Visual Studio)

Artículo
01/12/2024

Especifica una carpeta que se agregará al proyecto.

Sintaxis

<Folder Name="Project Folder">
    <Folder> ... </Folder>
    <ProjectItem> ... </ProjectItem>
</Folder>

Atributos y elementos

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

Atributos

Atributo	Descripción
`Name`	Atributo necesario. Nombre de la carpeta del proyecto.
`TargetFolderName`	Atributo opcional. Especifica el nombre que se va a asignar a la carpeta cuando se crea un proyecto a partir de la plantilla. Este atributo es útil para usar el reemplazo de parámetros para crear un nombre de carpeta o asignar un nombre a una carpeta con una cadena internacional que no se puede usar directamente en el archivo .zip .

Elementos secundarios

Elemento	Descripción
`Folder`	Especifica una carpeta que se va a agregar al proyecto. `Folder` los elementos pueden contener elementos secundarios `Folder` .
ProjectItem	Especifica un archivo que se va a agregar al proyecto.

Elementos primarios

Elemento	Descripción
Proyecto	Elemento secundario opcional de TemplateContent.

Comentarios

Folder es un elemento secundario opcional de Project.

Puede usar cualquiera de los métodos siguientes para organizar los elementos del proyecto en carpetas de una plantilla:

Incluya las carpetas en el archivo .zip de plantilla y agréguelas al proyecto en el archivo .vstemplate especificando la ruta de acceso al archivo en los ProjectItem elementos, sin Folder elementos. Éste es el método recomendado. Por ejemplo:

...

<ProjectItem>\Folder\item.cs</ProjectItem>

<ProjectItem>Form1.cs</ProjectItem>

...
Incluya las carpetas en el archivo .zip de plantilla y agréguelas al proyecto en el archivo .vstemplate con Folder elementos . Por ejemplo:

...

<Folder name="Folder">

<ProjectItem>item.cs</ProjectItem>

</Folder>

<ProjectItem>Form1.cs</ProjectItem>

...
No incluya carpetas en el archivo .zip de plantilla, pero agregue carpetas mediante el TargetFileName atributo del ProjectItem elemento . Por ejemplo:

...

<ProjectItem TargetFileName="\Folder\item.cs">item.cs</ProjectItem>

<ProjectItem>Form1.cs</ProjectItem>

...

Ejemplo

En el ejemplo siguiente se muestran los metadatos de una plantilla de proyecto para una aplicación de Windows de 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 template</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyTemplate.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <Folder Name="Properties">
                <ProjectItem>AssemblyInfo.cs</ProjectItem>
                <ProjectItem>Resources.resx</ProjectItem>
                <ProjectItem>Resources.Designer.cs</ProjectItem>
                <ProjectItem>Settings.settings</ProjectItem>
                <ProjectItem>Settings.Designer.cs</ProjectItem>
            </Folder>
        </Project>
    </TemplateContent>
</VSTemplate>

Share via