Tarefa CreateItem

Preenche item coleções com os itens de entrada.Isso permite que os itens a serem copiados de uma lista para outra.

Observação
Esta tarefa está obsoleto.Iniciando com.NET Framework 3.5, grupos de itens podem ser colocados dentro de destino elementos.Para obter mais informações, consulte Itens do MSBuild.

Atributos

A tabela a seguir descreve os parâmetros da CreateItem tarefa.

Parâmetro	Descrição
AdditionalMetadata	Opcional String parâmetro de matriz. Especifica metadados adicionais para anexar os itens de saída.Especifique o nome de metadados e o valor do item com a seguinte sintaxe: MetadataName=MetadataValue Vários pares de nome/valor de metadados devem ser separados por ponto e vírgula.Se o nome ou o valor contiver um ponto e vírgula ou outros caracteres especiais, eles devem ser antecedidos.Para obter mais informações, consulte Como: usar caracteres especiais no MSBuild.
Exclude	Opcional ITaskItem[] parâmetro de saída. Especifica os itens a serem excluídos da coleção de itens de saída.Este parâmetro pode conter especificações curinga.Para obter mais informações, consulte Itens do MSBuild e Como: excluir arquivos da compilação.
Include	Obrigatório ITaskItem[]parâmetro. Especifica os itens a serem incluídos na coleção de itens de saída.Este parâmetro pode conter especificações curinga.
PreserveExistingMetadata	Opcional Boolean parâmetro. Se True, só se aplicam os metadados adicionais, caso ainda não existam.

Comentários

Com os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension herda de classe, que por si só a Task classe.Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base TaskExtension.

Exemplo

O exemplo de código a seguir cria uma nova coleção item denominada MySourceItemsWithMetadata da coleção item MySourceItems.O CreateItem tarefa preenche a nova coleção de item com os itens na MySourceItems item.Em seguida, adiciona uma entrada de metadados adicionais chamada MyMetadata com um valor de Hello a cada item na nova coleção.

Depois que a tarefa é executada, o MySourceItemsWithMetadata item coleção contém itens file1.resx e file2.resx, ambos com entradas de metadados para MyMetadata.O MySourceItems item coleção é alterada.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <MySourceItems Include="file1.resx;file2.resx" />
    </ItemGroup>

    <Target Name="NewItems">
        <CreateItem
            Include="@(MySourceItems)"
            AdditionalMetadata="MyMetadata=Hello">
           <Output
               TaskParameter="Include"
               ItemName="MySourceItemsWithMetadata"/>
        </CreateItem>

    </Target>

</Project>

A tabela a seguir descreve o valor do item de saída após a execução da tarefa.Os metadados de item é mostrado entre parênteses após o item.

Coleção de item	Contents
MySourceItemsWithMetadata	file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello")

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild