CreateItem (Tarea)
Rellena las colecciones de elementos con los elementos de entrada.Esto permite copiar los elementos de una lista en otra.
[!NOTA]
Esta tarea está desusada.A partir de .NET Framework 3.5, los grupos de elementos se pueden colocar dentro de elementos Target.Para obtener más información, vea Elementos de MSBuild.
Atributos
En la siguiente tabla se describen los parámetros de la tarea CreateItem.
Parámetro |
Descripción |
|---|---|
AdditionalMetadata |
Parámetro de matriz 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: nombreDeMetadatos=valorDeMetadatos 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 de salida 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: Excluir archivos de la compilación. |
Include |
Parámetro ITaskItem[] requerido. 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. |
PreserveExistingMetadata |
Parámetro Boolean opcional. Si es True, solo se aplican los metadatos adicionales si no existen ya. |
Comentarios
Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que hereda de la clase Task.Para obtener una lista de estos parámetros adicionales y sus descripciones, vea TaskExtension (Clase base).
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 MySourceItems.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 file2.resx, ambos con entradas de metadatos para 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;file2.resx" />
</ItemGroup>
<Target Name="NewItems">
<CreateItem
Include="@(MySourceItems)"
AdditionalMetadata="MyMetadata=Hello">
<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") file2.resx (MyMetadata="Hello") |