Tarefa CreateItem
Preenche item coleções com os itens de entrada. Isso permite que os itens a serem copiados de uma lista para outra.
Dica
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 escapar 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 TaskExtension (base).
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") |