Elemento ProjectItem (modelos de projeto do Visual Studio)

Especifica um arquivo incluído no modelo de projeto.

Observação:
The ProjectItem elemento aceita atributos diferentes, dependendo se o modelo para um item ou um projeto. Este tópico explica o ProjectItem elemento para modelos de projeto. Para obter uma explicação sobre o ProjectItem elemento para modelos de item, consulte Elemento ProjectItem (modelos de item do Visual Studio).

<ProjectItem
    TargetFileName="TargetFileName.ext"
    ReplaceParameters="true/false"
    OpenInEditor="true/false"
    OpenInWebBrowser="true/false"
    OpenInHelpBrowser="true/false"
    OpenOrder="Value">
        FileName.ext
</ProjectItem>

Atributos e elementos

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

Atributos

Elementos filho

Nenhum.

Elementos pai

Valor de texto

É necessário um valor de texto.

A string que representa o nome ou o caminho para um arquivo no modelo. arquivo zip.

Comentários

ProjectItem é um filho opcional Project.

The TargetFileName atributo pode ser usado para criar uma estrutura de diretório diferente da estrutura do diretório no modelo. arquivo zip. Por exemplo, se o arquivo MyFile.vb existe na raiz do modelo. arquivo zip, mas deseja que o arquivo possa ser inserido em um diretório chamado CustomFiles todos os projetos criados a partir do modelo, você usaria o seguinte XML:

<ProjectItem TargetFileName="CustomFiles\MyFile.vb">MyFile.vb</ProjectItem>

The TargetFileName atributo também pode ser usado para renomear os arquivos que contêm caracteres internacionais em seus nomes de arquivos. Por exemplo, um modelo. arquivo zip não pode conter nomes de arquivo com caracteres Unicode, para que o arquivo deve ser renomeado antes que pode ser compactado em um. arquivo zip.The TargetFileName atributo pode ser usado para conjunto nome de arquivo de volta ao nome de arquivo original do Unicode.

The TargetFileName atributo também pode ser usado para renomear arquivos com parâmetros. O procedimento a seguir explica como renomear o arquivo MyFile.vb, que existe no diretório raiz do arquivo de modelo .zip, com um nome de arquivo com base no nome do projeto.

Para renomear arquivos com parâmetros

1. Use o seguinte XML no arquivo .vstemplate:

   <ProjectItem TargetFileName="$safeprojectname$.vb">MyFile.vb</ProjectItem>
   

2. Abra o arquivo de projeto (.vbproj um Visual Basic projeto) em um editor de texto ou Visual Studio. Para obter mais informações sobre a edição de arquivos de projeto no vsprvs, consulte Como: Editar arquivos de projeto.

3. localizar a linha no arquivo de projeto que se pareça com o seguinte XML:

   <Compile Include="MyFile.vb">
   

4. Substitua a linha de código com o seguinte XML:

   <Compile Include="$safeprojectname$.vb">
   

   Quando um projeto é criado com base neste modelo, nome de arquivo será baseado no nome que o usuário inseriu no Novo projetocaixa de diálogo de com todos os caracteres inseguros e espaços removidos.Para obter mais informações, consulte Parâmetros de modelo.

Exemplo

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

<VSTemplate Type="Project" Version="2.0.0"
    xmlns="https://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 ReplaceParameters="true">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>

Consulte também

Tarefas

Como: Criar manualmente modelos de projeto

Conceitos

Parâmetros de modelo

Como: Iniciar arquivos específicos ao Abrindo Modelos

Referência

Referência de esquema de modelo do Studio Visual

Elemento ProjectItem (modelos de item do Visual Studio)

Outros recursos

Modelos Visual Studio