Elemento ItemGroup (MSBuild)

  • Artículo

Contiene un conjunto de elementos Item definidos por el usuario. Cada elemento que se utiliza en un proyecto de MSBuild debe especificarse como elemento secundario de un elemento ItemGroup.

<Project><ItemGroup>

Sintaxis

<ItemGroup Condition="'String A' == 'String B'"
           Label="Label">
    <Item1>... </Item1>
    <Item2>... </Item2>
</ItemGroup>

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
Condition Atributo opcional. Condición que se va a evaluar. Para obtener más información, consulte Condiciones.
Label Atributo opcional. Identifica la ItemGroup.

Elementos secundarios

Elemento Descripción
Item Define las entradas para el proceso de compilación. Puede haber cero o más elementos Item en un ItemGroup.

Además del elemento Item genérico, ItemGroup permite que los elementos secundarios que representan tipos de elementos, como Reference, ProjectReference, Compile y otros, enumerados en Elementos comunes de proyectos de MSBuild.

Elementos primarios

Elemento Descripción
Proyecto Elemento raíz necesario de un archivo de proyecto de MSBuild.
Target A partir de .NET Framework 3.5, el elemento ItemGroup puede aparecer dentro de un elemento Target. Para obtener más información, consulte Destinos.

Ejemplo

En el ejemplo de código siguiente se muestran las colecciones de elementos definidos por el usuario Res y CodeFiles declaradas dentro de un elemento ItemGroup. Cada uno de los elementos de la colección de elementos Res contiene un elemento secundario ItemMetadata definido por el usuario.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Res Include = "Strings.fr.resources" >
            <Culture>fr</Culture>
        </Res>
        <Res Include = "Dialogs.fr.resources" >
            <Culture>fr</Culture>
        </Res>

        <CodeFiles Include="**\*.cs" Exclude="**\generated\*.cs" />
        <CodeFiles Include="..\..\Resources\Constants.cs" />
    </ItemGroup>
...
</Project>

En un archivo de proyecto simple, normalmente se usa un solo elemento ItemGroup, pero también se pueden utilizar varios elementos ItemGroup. Cuando se utilizan varios elementos ItemGroup, los elementos se combinan en un solo ItemGroup. Por ejemplo, algunos elementos podrían estar incluidos en un elemento ItemGroup independiente que se define en un archivo importado.

Pueden aplicarse condiciones a los elementos ItemGroup mediante el atributo Condition. En ese caso, los elementos solo se agregan a la lista de elementos si se cumple la condición. Consulte Condiciones de MSBuild.

El atributo Label se utiliza en algunos sistemas de compilación como una manera de controlar los comportamientos de la compilación. Solo se puede usar en declaraciones, como una manera de crear scripts de MSBuild más comprensibles o como una configuración de control para que afecte a las acciones de compilación.

Vea también