Item – Element (MSBuild)ItemGroup element (MSBuild)

  • 2 min ke čtení

Obsahuje sadu uživatelsky definovaných prvků položky .Contains a set of user-defined Item elements. Všechny položky používané v projektu MSBuild musí být zadány jako podřízený ItemGroup prvek elementu.Every item used in an MSBuild project must be specified as a child of an ItemGroup element.

<Project> <ItemGroup>

SyntaxSyntax

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

Atributy a elementyAttributes and elements

Následující části popisují atributy, podřízené prvky a nadřazené prvky.The following sections describe attributes, child elements, and parent elements.

AtributyAttributes

AtributAttribute PopisDescription
Condition Nepovinný atribut.Optional attribute. Podmínka, která má být vyhodnocena.Condition to be evaluated. Další informace najdete v tématu podmínky.For more information, see Conditions.
Label Nepovinný atribut.Optional attribute. Identifikuje ItemGroup .Identifies the ItemGroup.

Podřízené prvkyChild elements

ElementElement PopisDescription
PoložkaItem Definuje vstupy procesu sestavení.Defines the inputs for the build process. Může existovat nula nebo více Item prvků v ItemGroup .There may be zero or more Item elements in an ItemGroup.

Nadřazené prvkyParent elements

ElementElement PopisDescription
ProjektProject Požadovaný kořenový element souboru projektu MSBuild.Required root element of an MSBuild project file.
CílovéTarget Počínaje .NET Framework 3,5 se ItemGroup element může objevit uvnitř Target elementu.Starting with .NET Framework 3.5, the ItemGroup element can appear inside a Target element. Další informace najdete v tématu cíle.For more information, see Targets.

PříkladExample

Následující příklad kódu ukazuje uživatelsky definované kolekce položek Res a CodeFiles deklarované uvnitř ItemGroup elementu.The following code example shows the user-defined item collections Res and CodeFiles declared inside of an ItemGroup element. Každá položka v Res kolekci položek obsahuje uživatelsky definovaný podřízený element ItemMetadata – .Each of the items in the Res item collection contains a user-defined child 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ů.In a simple project file, you normally use a single ItemGroup element, but you can also use multiple ItemGroup elements. Je-li ItemGroup použito více prvků, položky jsou zkombinovány do jediného prvku ItemGroup .When multiple ItemGroup elements are used, items are combined into a single ItemGroup. Některé položky mohou být například obsaženy v samostatném ItemGroup prvku, který je definován v importovaném souboru.For example, some items might be included by a separate ItemGroup element that's defined in an imported file.

ItemGroups může mít podmínky použité pomocí Condition atributu.ItemGroups can have conditions applied by using the Condition attribute. V takovém případě jsou položky přidány do seznamu položek pouze v případě, že je podmínka splněna.In that case, the items are only added to the item list if the condition is satisfied. Zobrazit podmínky nástroje MSBuildSee MSBuild conditions

LabelAtribut se používá v některých systémech sestavení jako způsob řízení chování sestavení.The Label attribute is used in some build systems as a way to control build behaviors. Můžete ji použít pouze v deklaracích, jako způsob vytvoření více srozumitelných skriptů MSBuild nebo jako nastavení ovládacího prvku pro ovlivnění akcí sestavení.You can use it only in declarations, as a way to create more understandable MSBuild scripts, or as a control setting to affect build actions.

Viz takéSee also