Elemento de pasta (modelos de projeto do Visual Studio)

Artigo
01/12/2024

Especifica uma pasta que será adicionada ao projeto.

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
`Name`	Atributo obrigatório. O nome da pasta do projeto.
`TargetFolderName`	Atributo opcional . Especifica o nome a ser dado à pasta quando um projeto é criado a partir do modelo. Esse atributo é útil para usar a substituição de parâmetros para criar um nome de pasta ou nomear uma pasta com uma cadeia de caracteres internacional que não pode ser usada diretamente no arquivo .zip .

Elementos filho

Elemento	Descrição
`Folder`	Especifica uma pasta a ser adicionada ao projeto. `Folder` podem conter elementos filho `Folder` .
ProjectItem	Especifica um arquivo a ser adicionado ao projeto.

Elementos pai

Elemento	Descrição
Projeto	Elemento filho opcional de TemplateContent.

Comentários

Folder é um filho opcional de Project.

Você pode usar qualquer um dos seguintes métodos para organizar itens de projeto em pastas em um modelo:

Inclua as pastas no arquivo de .zip de modelo e adicione-as ao projeto no arquivo .vstemplate especificando o caminho para o arquivo nos ProjectItem elementos, sem Folder elementos. Esse é o método recomendado. Por exemplo:

...

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

<ProjectItem>Form1.cs</ProjectItem>

...
Inclua as pastas no arquivo de .zip de modelo e adicione-as ao projeto no arquivo .vstemplate com Folder elementos. Por exemplo:

...

<Folder name="Folder">

<ProjectItem>item.cs</ProjectItem>

</Folder>

<ProjectItem>Form1.cs</ProjectItem>

...
Não inclua pastas no arquivo de .zip modelo, mas adicione pastas usando o TargetFileNameProjectItem atributo do elemento . Por exemplo:

...

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

<ProjectItem>Form1.cs</ProjectItem>

...

Exemplo

O exemplo a seguir ilustra os metadados de um modelo de projeto para um aplicativo Visual C# do Windows.

<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>

Compartilhar via