CreateItem (tarea)

  • Artículo

Rellena las colecciones de elementos con los elementos de entrada. Esto permite copiar los elementos de una lista en otra.

Nota

Esta tarea está en desuso. A partir de .NET Framework 3.5, los grupos de elementos se pueden colocar dentro de elementos Target. Para obtener más información, consulte Elementos.

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: Usar 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 especificaciones del comodín. Para obtener más información, vea Elementos y Cómo: Excluir archivos de la compilación.
Include Parámetro ITaskItem[]obligatorio.

Especifica los elementos que se incluirán en la colección de elementos de salida. Este parámetro puede contener las especificaciones 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 a su vez hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, consulte TaskExtension base class.

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="http://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