Elemento de item (MSBuild)
Contém um item definido pelo usuário e seus metadados.cada item que é usado em um projeto de MSBuild deve ser especificado como um filho de um elemento de ItemGroup .
<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 elementos filho, atributos, e elementos pai.
Atributos
Atributo |
Descrição |
|---|---|
Include |
Atributo necessário. O arquivo ou a curinga para incluir na lista de itens. |
Exclude |
atributo opcional. O arquivo ou a curinga para excluir a lista de itens. |
Condition |
atributo opcional. A condição a ser avaliada.Para obter mais informações, consulte Condições do MSBuild. |
Remove |
atributo opcional. O arquivo ou a curinga para remover da lista de itens. Esse atributo é válido somente se especificado para um item em ItemGroup que está em Target. |
KeepMetadata |
atributo opcional. Os metadados para que os itens de origem para adicionar itens de destino.Somente os metadados cujos nomes são especificados na lista delimitada por ponto-e-vírgula de um item são transferidos de origem a um item de destino.Para obter mais informações, consulte Itens do MSBuild. Esse atributo é válido somente se especificado para um item em ItemGroup que está em Target. |
RemoveMetadata |
atributo opcional. Os metadados para que os itens de origem não transfiram para itens de destino.Todos os metadados são transferidos de um item de origem a um item de destino exceto os metadados cujos nomes estão contidos na lista delimitada por ponto-e-vírgula nomes de.Para obter mais informações, consulte Itens do MSBuild. Esse atributo é válido somente se especificado para um item em ItemGroup que está em Target. |
KeepDuplicates |
atributo opcional. Especifica se um item deve ser adicionado a grupo-alvo se é uma cópia exata de um item existente.Se o item de origem e de destino tem o mesmo valor de Include mas metadados diferentes, o item é adicionado mesmo se KeepDuplicates é definido como false.Para obter mais informações, consulte Itens do MSBuild. Esse atributo é válido somente se especificado para um item em ItemGroup que está em Target. |
Elementos filho
Elemento |
Descrição |
|---|---|
Uma chave definido pelo usuário de metadados do item, que contém o valor de metadados do item.pode haver zero ou mais elementos de ItemMetadata em um item. |
Elementos pai
Elemento |
Descrição |
|---|---|
Elemento de agrupamento para itens. |
Comentários
os elementos deItem definem entradas no sistema de compilação, e são agrupados em coleções de item com base em seus nomes definidos pelo usuário da coleção.Essas coleções de item podem ser usadas como parâmetros para tarefas, que usam os itens individuais em coleções para executar as etapas do processo de compilação.Para obter mais informações, consulte Itens do MSBuild.
Usar notação @(tipo) permite uma coleção de itens do tipo tipo a ser expandido em uma lista delimitada por ponto-e-vírgula de cadeias de caracteres, e passado como um parâmetro.Se o parâmetro é do tipo string, o valor do parâmetro é a lista de elementos, separadas por ponto-e-vírgula.Se o parâmetro for uma matriz de cadeias de caracteres (string[]), e cada elemento é inserido na matriz com base no local de ponto-e-vírgula.Se o parâmetro de tarefa é do tipo ITaskItem[], o valor é o conteúdo da coleção de item junto com todos os metadados anexados.Para limitar cada item usando um caractere diferente de um ponto-e-vírgula, use a sintaxe @(tipo, 'separador').
O mecanismo de MSBuild pode avaliar curingas como * e ? e curingas recursivos 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 item declarado 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>