ItemGroup – element (MSBuild)

  • Článek

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.

Atributy

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

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

Viz také