Elemento Project (modelos do Visual Studio)

Artigo
04/10/2024

Especifica os arquivos ou diretórios a serem adicionados ao projeto.

Syntax

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

Atributos e elementos

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

Atributos

Atributo	Descrição
`File`	Atributo obrigatório. Especifica o nome do arquivo de projeto no arquivo de .zip modelo.
`ReplaceParameters`	Atributo opcional . Um valor booleano que especifica se o arquivo de projeto tem valores de parâmetro que devem ser substituídos quando um projeto é criado a partir do modelo. O valor padrão é `false`.
`TargetFileName`	Atributo opcional . Especifica o nome do arquivo de projeto quando um projeto é criado a partir do modelo.
`IgnoreProjectParameter`	Atributo opcional . Especifica se o projeto deve ser adicionado à solução atual. Se o valor do parâmetro personalizado, "$myCustomParameter$" existir no arquivo de substituição de parâmetro, o projeto será criado, mas não adicionado como parte da solução aberta no momento.

Elementos filho

Elemento	Descrição
Pasta	Elemento opcional. Especifica uma pasta a ser adicionada ao projeto.
ProjectItem	Elemento opcional. Especifica um arquivo a ser adicionado a um projeto.

Elementos pai

Elemento	Descrição
TemplateContent	Elemento necessário.

Comentários

Project é um elemento filho opcional do TemplateContent.

O Project elemento é usado para especificar um projeto e, portanto, só é válido em modelos de projeto.

Project elementos podem ter elementos filhos Folder ou elementos filhos ProjectItem , mas não uma mistura de ambos e FolderProjectItem elementos filhos.

O Visual Studio renomeia automaticamente o nome do arquivo de projeto com base no nome inserido pelo usuário na caixa de diálogo Novo Projeto . Use o TargetFileName atributo se desejar fornecer um nome de arquivo alternativo para arquivos de projeto criados com o modelo.

Exemplo

O exemplo a seguir mostra os metadados para um modelo de projeto de um aplicativo do 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>

Compartilhar via