ItemGroup – element (MSBuild)

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 .

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

Attributes

Vlastnost Description
Condition Volitelný atribut. Podmínka, která se má vyhodnotit. Další informace naleznete v tématu Podmínky.
Label Volitelný atribut. ItemGroupIdentifikuje .

Podřízené prvky

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

prvek Description
Projekt Povinný kořenový prvek souboru projektu MSBuild.
Cíl Prvek ItemGroup se může objevit uvnitř elementu Target . Další informace naleznete v tématu Cíle.

Example

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

Viz také

  • Last updated on