CreateItem (Tarea)
Actualización: noviembre 2007
Rellena las colecciones de elementos con los elementos de entrada. Esto permite copiar los elementos de una lista en otra.
Atributos
En la siguiente tabla se describen los parámetros de la tarea CreateItem.
Parámetro |
Descripción |
|---|---|
AdditionalMetadata |
Parámetro String opcional. Especifica los metadatos adicionales que se adjuntarán a los elementos de salida. Especifique el nombre y valor de los metadatos para el elemento empleando la siguiente sintaxis: MetadataName=MetadataValue En caso de múltiples pares de nombre/valor de metadatos, se deberán separar con un punto y coma. Si el nombre o el valor contiene un punto y coma o cualquier otro carácter especial, deben ser de escape. Para obtener más información, vea Cómo: Utilizar caracteres de escape especiales en MSBuild. |
Exclude |
Parámetro ITaskItem[] opcional. Especifica los elementos que se excluirán de la colección de elementos de salida. Este parámetro puede contener las característica técnicas del comodín. Para obtener más información, vea Elementos de MSBuild y Cómo: Generar todos los archivos de un directorio excepto uno. |
Include |
Parámetro de salida ITaskItem[] opcional. Especifica los elementos que se incluirán en la colección de elementos de salida. Este parámetro puede contener las característica técnicas del comodín. |
Ejemplo
En el ejemplo de código siguiente se crea una nueva colección de elementos denominada MySourceItemsWithMetadata a partir de la colección de elementos MySourceItems. La tarea CreateItem rellena la nueva colección de elementos con los elementos de la colección de elementos MySourceItems que contiene valores MyAddMetadata de true. A continuación, agrega una entrada de metadatos adicional denominada MyMetadata con un valor de Hello en cada elemento de la nueva colección.
Una vez ejecutada la tarea, la colección de elementos MySourceItemsWithMetadata contiene los elementos file1.resx y file3.resx, ambos con entradas de metadatos para MyAddMetadata y MyMetadata. La colección de elementos MySourceItems se queda sin modificar.
<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>
En la siguiente tabla se describe el valor del elemento de salida después de la ejecución de la tarea. Los metadatos del elemento se muestran entre paréntesis después del elemento.
Colección de elementos |
Contenido |
|---|---|
MySourceItemsWithMetadata |
file1.resx (MyMetadata="Hello") file3.resx (MyMetadata="Hello") |