Elemento de item (MSBuild)

Artigo
08/01/2011

Contém um item definido pelo usuário e seus metadados. Cada item que é usado em um MSBuild projeto deve ser especificado como um filho de um ItemGroup elemento.

<Item Include="*.cs"
        Exclude="MyFile.cs"
        Remove="RemoveFile.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 na lista de itens.
Exclude	Atributo opcional. O arquivo ou um curinga para excluir da lista de itens.
Remove	Atributo opcional. O arquivo ou um curinga para remover da lista de itens. Este atributo só é válido quando ele for especificado para um item em um ItemGroup em de um Target.
Condition	Atributo opcional. A 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 do item. Pode haver zero ou mais ItemMetadata elementos em um item.

Elementos pai

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

Comentários

Itemelementos 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 como parâmetros para tarefas, que usam os itens individuais das coleções para executar as etapas do processo de compilação. Para obter mais informações, consulte Itens do MSBuild.

Usando a notação @(myType) permite que uma coleção de itens do tipo myType ser expandidos em uma lista delimitada por ponto-e-vírgula de seqüências de caracteres e passado para um parâmetro. Se o parâmetro é do tipo string, em seguida, 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[]), e cada elemento é inserido no array com base no local do ponto e vírgula. Se o parâmetro da tarefa for do tipo ITaskItem[], então o valor é o conteúdo da coleção item junto com quaisquer metadados anexado. Para delimitar a cada item usando um caractere diferente, por exemplo, um ponto e vírgula, use a sintaxe @(myType, 'separador').

O MSBuild engine pode avaliar os caracteres curinga, como * e ? e curingas de recursiva, como /**/*.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 declarado o item contém metadados que tem myAttribute definido como HelloWorld.

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

Consulte também

Conceitos

Itens do MSBuild

Propriedadesdo MSBuild

Referência de esquema do arquivo de projeto MSBuild

Compartilhar via