Elemento de item (MSBuild)
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. |
Elementos filho
Elemento |
Descrição |
|---|---|
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 |
|---|---|
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>