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")

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild