Partilhar via


Tarefa CreateItem

Popula as coleções de itens com os itens de entrada. Isso permite que os itens sejam copiados de uma lista para outra.

Observação

Essa tarefa foi preterida. Do .NET Framework 3.5 em diante, grupos de itens podem ser colocados dentro de elementos Target. Para obter mais informações, consulte Itens.

Atributos

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

Parâmetro Descrição
AdditionalMetadata Parâmetro de matriz String opcional.

Especifica os metadados adicionais para anexar aos 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 escapados. Para obter mais informações, confira Como fazer o escape de caracteres especiais no MSBuild.
Exclude Parâmetro de saída ITaskItem[] opcional.

Especifica os itens a serem excluídos da coleção de itens de saída. Esse parâmetro pode conter especificações de curinga. Para obter mais informações, confira Itens e Como excluir arquivos do build.
Include ITaskItem[]Parâmetro obrigatório.

Especifica os itens a serem incluídos na coleção de itens de saída. Esse parâmetro pode conter especificações de curinga.
PreserveExistingMetadata Parâmetro Boolean opcional.

Se True, somente os metadados adicionais se aplicarão, se eles ainda não existirem.

Comentários

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, confira Classe base TaskExtension.

Exemplo

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

Depois que a tarefa for executada, a coleção de itens MySourceItemsWithMetadata conterá os itens file1.resx e file2.resx, ambos com entradas de metadados para MyMetadata. A coleta do item MySourceItems permanece inalterada.

<Project xmlns="http://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 do item são mostrados entre parênteses após o item.

Coleta de itens Sumário
MySourceItemsWithMetadata file1.resx (MyMetadata="Hello")

file2.resx (MyMetadata="Hello")

Confira também