Elemento ProjectItem (modelos de item do Visual Studio)

Especifica um arquivo incluído no modelo de item.

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 de item. Para obter uma explicação sobre o ProjectItem elemento para modelos de projeto, consulte Elemento ProjectItem (modelos de projeto do Visual Studio).

<ProjectItem
    SubType="Form/Component/CustomControl/UserControl"
    ReplaceParameters="true/false"
    TargetFileName="TargetFileName.ext">
        FileName.ext
</ProjectItem>

Atributos e elementos

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

Atributos

Atributo	Descrição
SubType	Atributo opcional. Especifica o subtipo de um item em multi-arquivo modelo de item.Esse valor é usado para determinar o editor que Visual Studio usará para em em aberto o item.
ReplaceParamenters	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.
TargetFileName	Atributo opcional. Especifica o nome do item é criado a partir do modelo.Esse atributo é útil para uso de substituição de parâmetro para criar um nome de item.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
TemplateContent	Especifica o Sumário do modelo.

Valor de texto

É necessário um valor de texto.

A string que representa o nome de um arquivo no modelo. arquivo zip.

Comentários

ProjectItem é um filho opcional TemplateContent.

The TargetFileName atributo pode ser usado para renomear arquivos com parâmetros. Por exemplo, se o arquivo MyFile.vb existe no diretório raiz do arquivo .zip de modelo, mas desejar o arquivo a ser nomeado com base no nome de arquivo fornecido pelo usuário na Adicionar novo item caixa de diálogo, você usaria o seguinte XML:

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

Quando um item é criado com base neste modelo, o nome de arquivo será baseado no nome que o usuário inseriu no Adicionar novo item caixa de diálogo.Isso é útil durante a criação de modelos de item multiarquivos.Para obter mais informações, consulte Como: Criar modelos de item multiarquivos e Parâmetros de modelo.

Exemplo

O exemplo a seguir ilustra os metadados para o modelo de item padrão para um Visual C# classe.

<VSTemplate Type="Item" Version="2.0.0"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>MyClass</Name>
        <Description>My custom C# class.</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <DefaultName>MyClass.cs</DefaultName>
    </TemplateData>
    <TemplateContent>
        <ProjectItem ReplaceParameters="true">MyClass.cs</ProjectItem>
    </TemplateContent>
</VSTemplate>

Consulte também

Tarefas

Como: Criar modelos de item multiarquivos

Conceitos

Parâmetros de modelo

Referência

Referência de esquema de modelo do Studio Visual

Outros recursos

Modelos Visual Studio