Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Contient un ensemble d’éléments Item définis par l’utilisateur. Chaque élément utilisé dans un projet MSBuild doit être spécifié en tant qu’enfant d’un ItemGroup élément.
<Project><ItemGroup>
Syntaxe
<ItemGroup Condition="'String A' == 'String B'"
Label="Label">
<Item1>... </Item1>
<Item2>... </Item2>
</ItemGroup>
Attributs et éléments
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributes
| Caractéristique | Descriptif |
|---|---|
Condition |
Attribut facultatif. Condition à évaluer. Pour plus d’informations, consultez Conditions. |
Label |
Attribut facultatif. Identifie le ItemGroup. |
Éléments enfants
| Élément | Descriptif |
|---|---|
| élément | Définit les entrées du processus de génération. Il peut y avoir zéro ou plusieurs Item éléments dans un ItemGroup. |
En plus de l’élément générique Item , ItemGroup permet aux éléments enfants qui représentent des types d’éléments, tels que Reference, ProjectReference, Compileet d’autres comme répertoriés dans les éléments de projet MSBuild communs.
Éléments parents
| Élément | Descriptif |
|---|---|
| Projet | Élément racine requis d’un fichier projet MSBuild. |
| Cible | L’élément ItemGroup peut apparaître à l’intérieur d’un Target élément. Pour plus d’informations, consultez Cibles. |
Example
L’exemple de code suivant montre les collections Res d’éléments définies par l’utilisateur et CodeFiles déclarées à l’intérieur d’un ItemGroup élément. Chacun des éléments de la Res collection d’éléments contient un élément ItemMetadata enfant défini par l’utilisateur.
<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>
Dans un fichier projet simple, vous utilisez normalement un seul ItemGroup élément, mais vous pouvez également utiliser plusieurs ItemGroup éléments. Lorsque plusieurs ItemGroup éléments sont utilisés, les éléments sont combinés en un seul ItemGroup. Par exemple, certains éléments peuvent être inclus par un élément distinct ItemGroup défini dans un fichier importé.
ItemGroups peut avoir des conditions appliquées à l’aide de l’attribut Condition . Dans ce cas, les éléments sont ajoutés uniquement à la liste d’éléments si la condition est satisfaite. Voir les conditions MSBuild
L’attribut Label est utilisé dans certains systèmes de génération comme moyen de contrôler les comportements de génération. Vous pouvez l’utiliser uniquement dans les déclarations, comme moyen de créer des scripts MSBuild plus compréhensibles ou en tant que paramètre de contrôle pour affecter les actions de génération.