Item – Element (MSBuild)ItemGroup element (MSBuild)
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ílTarget | 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
Label
Atribut 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.