Compartilhar via


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

Atributo

Descrição

TargetFileName

Atributo opcional.

Especifica o nome e caminho do item de projeto quando um projeto é criado a partir do modelo.Esse atributo é útil para criar uma estrutura de diretório diferente da estrutura do diretório no modelo. arquivo zip, ou para usar a substituição de parâmetro para criar um nome de item.

ReplaceParameters

Atributo opcional.

Um valor booliano que especifica se o item possui valores de parâmetro devem ser substituídos quando um projeto é criado a partir do modelo.Valor padrão é false.

OpenInEditor

Atributo opcional.

Um valor booliano que especifica se o item deve ser aberto no editor de respectivo em Visual Studio Quando um projeto é criado a partir do modelo.

The OpenInWebBrowser e OpenInHelpBrowser atributos são ignorados em um item com um OpenInEditor valor de true.

O valor padrão é false.

OpenInWebBrowser

Atributo opcional.

Um valor booliano que especifica se o item deve ser aberto no navegador da Web quando um projeto é criado a partir do modelo.

Somente arquivos HTML e texto que são locais para o projeto pode ser aberto no navegador da Web.URLs externas não podem ser abertos com esse atributo.

O valor padrão é false.

OpenInHelpBrowser

Atributo opcional.

Um valor booliano que especifica se o item deve ser aberto no Visualizador da Ajuda quando um projeto é criado a partir do modelo.

Somente arquivos HTML e texto que são locais para o projeto pode ser aberto no navegador ajuda.URLs externas não podem ser abertos com esse atributo.

O valor padrão é false.

OpenOrder

Atributo opcional.

Especifica um valor numérico que representa a ordem em que itens serão abertos em seus respectivos editores.Todos os valores devem ser múltiplos de 10.Itens com menor OpenOrder valores são abertos pela primeira vez.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

Project

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

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