Tarefa CreateItem
Preenche item coleções com a entrada s item. Isso permite que os itens a serem copiados de uma lista para outro.
Atributos
A tabela a seguir descreve os parâmetros do CreateItem tarefa.
Parâmetro |
Descrição |
|---|---|
AdditionalMetadata |
Opcional String parâmetro. Especifica os metadados adicionais para anexar os itens de saída. Especifique o nome de metadados e o valor para o 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 vir seguidas pelo caractere de escape. Para obter mais informações, consulte Como: Escape a caracteres EEspecial no MSBuild. |
Exclude |
Opcional ITaskItem[] parâmetro. Especifica o item s para excluir da saída item coleção. Este parâmetro pode conter as especificações de curinga. Para obter mais informações, consulte Itens do MSBuild e Como: ComCompilação Tudo arquivos em um diretório, exceto um. |
Include |
Opcional ITaskItem[] parâmetro de saída. Especifica o s item para incluir na saída item coleção. Este parâmetro pode conter as especificações de curinga. |
Exemplo
O exemplo de código a seguir cria uma nova coleção item denominada MySourceItemsWithMetadata da coleção de item MySourceItems. The CreateItem preenche a nova tarefa item coleção com o s item na MySourceItems item coleção que contêm MyAddMetadata valores de true. Ele, em seguida, adiciona uma entrada de metadados adicionais chamada MyMetadata com um valor de Hello cada item da nova coleção.
Depois que a tarefa for executada, o MySourceItemsWithMetadata coleção de itens contém itens file1.resx e file3.resx, ambos com entradas de metadados para MyAddMetadata e MyMetadata. The MySourceItems item de coleção não é alterada.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MySourceItems Include="file1.resx;file3.resx">
<MyAddMetadata>true</MyAddMetadata>
</MySourceItems>
<MySourceItems Include="file2.resx">
<MyAddMetadata>false</MyAddMetadata>
</MySourceItems>
</ItemGroup>
<PropertyGroup>
<MyValue>Hello</MyValue>
</PropertyGroup>
<Target Name="NewItems">
<CreateItem
Include="@(MySourceItems)"
Condition="'%(MyAddMetadata)'=='true'"
AdditionalMetadata="MyMetadata=$(MyValue)">
<Output
TaskParameter="Include"
ItemName="MySourceItemsWithMetadata"/>
</CreateItem>
</Target>
</Project>
A tabela a seguir descreve o valor do item saída após a execução da tarefa. Metadados de item é mostrado entre parênteses após o item.
Item de coleção |
Contents |
|---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file3.resx (MyMetadata="Hello") |