Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Enthält einen Satz von benutzerdefinierten Elementelementen . Jedes Element, das in einem MSBuild-Projekt verwendet wird, muss als untergeordnetes Element eines ItemGroup Elements angegeben werden.
<Project><ItemGroup>
Syntax
<ItemGroup Condition="'String A' == 'String B'"
Label="Label">
<Item1>... </Item1>
<Item2>... </Item2>
</ItemGroup>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
| Merkmal | Description |
|---|---|
Condition |
Optionales Attribut. Zu bewertende Bedingung. Weitere Informationen finden Sie unter Bedingungen. |
Label |
Optionales Attribut. Identifies the ItemGroup. |
Untergeordnete Elemente
| Element | Description |
|---|---|
| Element | Definiert die Eingaben für den Buildprozess. Es kann null oder mehr Item Elemente in einem ItemGroup. |
Zusätzlich zum generischen Item Element ermöglicht ItemGroup untergeordnete Elemente, die Typen von Elementen darstellen, z Reference. B. , , ProjectReference, Compileund andere elemente, die unter common MSBuild-Projektelementen aufgeführt sind.
Übergeordnete Elemente
| Element | Description |
|---|---|
| Projekt | Erforderliches Stammelement einer MSBuild-Projektdatei. |
| Ziel | Das ItemGroup Element kann innerhalb eines Target Elements angezeigt werden. Weitere Informationen finden Sie unter "Ziele". |
Example
Das folgende Codebeispiel zeigt die benutzerdefinierten Elementauflistungen Res und CodeFiles deklariert innerhalb eines ItemGroup Elements. Jedes element in der Res Elementauflistung enthält ein benutzerdefiniertes untergeordnetes 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>
In einer einfachen Projektdatei verwenden Sie normalerweise ein einzelnes ItemGroup Element, aber Sie können auch mehrere ItemGroup Elemente verwenden. Wenn mehrere ItemGroup Elemente verwendet werden, werden Elemente in einem einzigen ItemGroupkombiniert. Beispielsweise können einige Elemente durch ein separates ItemGroup Element eingeschlossen werden, das in einer importierten Datei definiert ist.
ItemGroups können Bedingungen mithilfe des Condition Attributs angewendet haben. In diesem Fall werden die Elemente nur der Elementliste hinzugefügt, wenn die Bedingung erfüllt ist. Siehe MSBuild-Bedingungen
Das Label Attribut wird in einigen Buildsystemen als Möglichkeit zum Steuern von Buildverhalten verwendet. Sie können es nur in Deklarationen verwenden, um verständlichere MSBuild-Skripts zu erstellen oder als Steuerelementeinstellung, um Buildaktionen zu beeinflussen.