ItemGroup – element (MSBuild)

Článek
10/13/2023

Obsahuje sadu uživatelem definovaných elementů Položky . Každá položka použitá v projektu MSBuild musí být zadána jako podřízený prvek ItemGroup .

Syntaxe

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut	Popis
`Condition`	Nepovinný atribut. Podmínka, která se má vyhodnotit. Další informace naleznete v tématu Podmínky.
`Label`	Nepovinný atribut. `ItemGroup`Identifikuje .

Podřízené prvky

Element (Prvek)	Popis
Položka	Definuje vstupy pro proces sestavení. Může existovat nula nebo více `Item` prvků v objektu `ItemGroup`.

Kromě obecného Item elementu ItemGroup umožňuje podřízené elementy, které představují typy položek, například Reference, ProjectReference, Compilea další, jak jsou uvedeny v common MSBuild položky projektu.

Nadřazené prvky

Element (Prvek)	Popis
Projekt	Povinný kořenový prvek souboru projektu MSBuild.
Cíl	Počínaje rozhraním .NET Framework 3.5 `ItemGroup` se prvek může objevit uvnitř elementu `Target` . Další informace naleznete v tématu Cíle.

Příklad

Následující příklad kódu ukazuje kolekce Res položek definované uživatelem a CodeFiles deklarované uvnitř elementu ItemGroup . Každá z položek v Res kolekci položek obsahuje uživatelem definovaný podřízený ItemMetadata element.

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

V jednoduchém souboru projektu obvykle používáte jeden ItemGroup prvek, ale můžete také použít více ItemGroup prvků. Při použití více ItemGroup prvků se položky zkombinují do jednoho ItemGroup. Některé položky mohou být například zahrnuty samostatným ItemGroup prvkem definovaným v importovaném souboru.

ItemGroups mohou mít podmínky použité pomocí atributu Condition . V takovém případě se položky přidají jenom do seznamu položek, pokud je podmínka splněná. Viz podmínky nástroje MSBuild

Atribut Label se používá v některých systémech sestavení jako způsob řízení chování sestavení. Můžete ho použít pouze v deklaracích, jako způsob, jak vytvořit srozumitelnější skripty MSBuild nebo jako nastavení ovládacího prvku, které ovlivní akce sestavení.

Sdílet prostřednictvím