Dela via

ItemGroup-element (MSBuild)

Innehåller en uppsättning användardefinierade objektelement . Varje objekt som används i ett MSBuild-projekt måste anges som underordnat till ett ItemGroup element.

<Projektobjektgrupp><>

Syntax

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attributes

Attribute Description
Condition Valfritt attribut. Villkor som ska utvärderas. Mer information finns i Villkor.
Label Valfritt attribut. Identifierar ItemGroup.

Underordnade element

Komponent Description
Föremål Definierar indata för byggprocessen. Det kan finnas noll eller flera Item element i en ItemGroup.

Förutom det allmänna Item elementet tillåter ItemGroup underordnade element som representerar typer av objekt, till exempel Reference, ProjectReference, Compileoch andra som anges i Vanliga MSBuild-projektobjekt.

Överordnade element

Komponent Description
Projekt Obligatoriskt rotelement i en MSBuild-projektfil.
Mål Elementet ItemGroup kan visas i ett Target element. Mer information finns i Mål.

Example

I följande kodexempel visas de användardefinierade objektsamlingarna Res och CodeFiles deklareras i ett ItemGroup element. Vart och ett av objekten i objektsamlingen Res innehåller ett användardefinierat underordnat ItemMetadata-element .

<Project>
    <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>

I en enkel projektfil använder du normalt ett enda ItemGroup element, men du kan också använda flera ItemGroup element. När flera ItemGroup element används kombineras objekt till en enda ItemGroup. Vissa objekt kan till exempel inkluderas av ett separat ItemGroup element som definieras i en importerad fil.

ItemGroups kan ha villkor som tillämpas med hjälp av attributet Condition . I så fall läggs objekten bara till i objektlistan om villkoret är uppfyllt. Se MSBuild-villkor

Attributet Label används i vissa byggsystem som ett sätt att kontrollera byggbeteenden. Du kan bara använda det i deklarationer, som ett sätt att skapa mer begripliga MSBuild-skript eller som en kontrollinställning för att påverka byggåtgärder.

Se även