Tarefa de CreateItem
Preenche as coleções de item 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 de tarefas.
Parâmetro |
Descrição |
|---|---|
AdditionalMetadata |
Opcional String parâmetro de matriz. Especifica os 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
Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension , a própria classe herda o Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de TaskExtension.
Exemplo
O exemplo de código a seguir cria uma nova coleção de item denominada MySourceItemsWithMetadata da coleção item MySourceItems. O CreateItem tarefa preenche a nova coleção de item com itens de MySourceItems item. Em seguida, adiciona uma entrada de metadados adicionais chamada MyMetadata com um valor de Hello para cada item na coleção de novo.
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") |