Elemento ItemGroup (MSBuild)

2025-08-15

Contiene un set di elementi Item definiti dall'utente. Ogni elemento usato in un progetto MSBuild deve essere specificato come figlio di un ItemGroup elemento.

Sintassi

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

Attributi ed elementi

Le sezioni seguenti descrivono attributi, elementi figlio ed elementi padre.

Attributes

Attribute	Description
`Condition`	Attributo facoltativo. Condizione da valutare. Per altre informazioni, vedere Condizioni.
`Label`	Attributo facoltativo. Identifica l'oggetto `ItemGroup`.

Elementi figlio

Elemento	Description
elemento	Definisce gli input per il processo di compilazione. In un oggetto `ItemGroup`possono essere presenti zero o più `Item` elementi.

Oltre all'elemento generico Item , ItemGroup consente elementi figlio che rappresentano tipi di elementi, ad esempio Reference, ProjectReference, Compilee altri, elencati in Elementi comuni del progetto MSBuild.

Elementi padre

Elemento	Description
Progetto	Elemento radice obbligatorio di un file di progetto MSBuild.
Destinazione	L'elemento `ItemGroup` può essere visualizzato all'interno di un `Target` elemento . Per altre informazioni, vedere Destinazioni.

Example

Nell'esempio di codice seguente vengono illustrati gli insiemi Res di elementi definiti dall'utente e CodeFiles dichiarati all'interno di un ItemGroup elemento . Ognuno degli elementi nella Res raccolta di elementi contiene un elemento ItemMetadata figlio definito dall'utente.

<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 un file di progetto semplice si usa in genere un singolo ItemGroup elemento, ma è anche possibile usare più ItemGroup elementi. Quando vengono usati più ItemGroup elementi, gli elementi vengono combinati in un singolo ItemGroupoggetto . Ad esempio, alcuni elementi potrebbero essere inclusi da un elemento separato ItemGroup definito in un file importato.

ItemGroups può avere condizioni applicate usando l'attributo Condition . In tal caso, gli elementi vengono aggiunti all'elenco di elementi solo se la condizione viene soddisfatta. Vedere condizioni di MSBuild

L'attributo Label viene usato in alcuni sistemi di compilazione come modo per controllare i comportamenti di compilazione. È possibile usarlo solo nelle dichiarazioni, come modo per creare script MSBuild più comprensibili o come impostazione di controllo per influire sulle azioni di compilazione.

Condividi tramite