Elemento de item (MSBuild)

Artigo
08/25/2010

Contém um item definido pelo usuário e seus metadados. Todos sistema autônomo itens usados em um MSBuild projeto deve ser especificado sistema autônomo um filho de um ItemGroup elemento.

<Item Include="*.cs"
        Exclude="MyFile.cs"
        Condition="'String A'=='String B'" >
    <ItemMetadata1>...</ItemMetadata1>
    <ItemMetadata2>...</ItemMetadata2>
</Item>

Atributos e elementos

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

Atributos

Atributo	Descrição
Include	Atributo obrigatório. O arquivo ou um curinga para incluir o item.
Exclude	Atributo opcional. O arquivo ou caractere curinga a ser excluído no item.
Condition	Atributo opcional. Condição a ser avaliada. Para obter mais informações, consulte Condições do MSBuild.

Include

Atributo obrigatório.

O arquivo ou um curinga para incluir o item.

Exclude

Atributo opcional.

O arquivo ou caractere curinga a ser excluído no item.

Condition

Atributo opcional.

Condição a ser avaliada. Para obter mais informações, consulte Condições do MSBuild.

Elementos filho

Elemento	Descrição
ItemMetadata	Uma chave de metadados de item definido pelo usuário, que contém o valor de metadados de item. Pode haver zero ou mais ItemMetadata elementos em um item.

Elementos pai

Elemento	Descrição
ItemGroup	Elemento de agrupamento de itens.

Comentários

Item elementos definem entradas no sistema de compilação e são agrupados em conjuntos de item com base em seus nomes de coleção definida pelo usuário. Essas coleções de item podem ser usadas sistema autônomo parâmetros para tarefas, que use sistema autônomo itens individuais contidos na coleção para executar sistema autônomo etapas do processo de compilação. Para obter mais informações, consulte Itens do MSBuild.

Usando a notação @(myType) permite a uma coleção de itens do tipo myType ser expandido em um ponto-e-vírgula (;) lista de seqüências de caracteres delimitada por e passado para um parâmetro. Se o parâmetro for de digite string, então, o valor do parâmetro é a lista de elementos separados por ponto-e-vírgula. Se o parâmetro é uma matriz de seqüências de caracteres (string[]), cada elemento é inserido no array com base no local do ponto-e-vírgula. Se o parâmetro da tarefa é de digitar ITaskItem[], o valor é o Sumário da coleção item com qualquer metadado associado. Para delimitar cada item com um caractere diferente de um ponto-e-vírgula, use a sintaxe @(myType, 'separador de ').

The MSBuild mecanismo é capaz de avaliar sistema autônomo caracteres curinga * e ? Assim sistema autônomo curingas recursiva sistema autônomo /**/*.cs. Para obter mais informações, consulte Itens do MSBuild.

Exemplo

O exemplo de código a seguir mostra como declarar dois itens do tipo CSFile. O segundo item declarado contém metadados com myAttribute definido como HelloWorld.

<ItemGroup>
    <CSFile Include="engine.cs; form.cs" />
    <CSFile Include="main.cs" >
        <MyMetadata>HelloWorld</MyMetadata>
    </Item>
</ItemGroup>

Consulte também

Conceitos

Itens do MSBuild

Propriedades do MSBuild

Referência de esquema de arquivo de projeto MSBuild

Partilhar via