ItemGroup, element (MSBuild)

  • Artykuł

Zawiera zestaw elementów elementu zdefiniowanego przez użytkownika. Każdy element używany w projekcie MSBuild musi być określony jako element podrzędny ItemGroup elementu.

<Grupa elementów projektu><>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut opis
Condition Atrybut opcjonalny. Warunek do oceny. Aby uzyskać więcej informacji, zobacz Warunki.
Label Atrybut opcjonalny. Identyfikuje element ItemGroup.

Elementy podrzędne

Element opis
Produkt Definiuje dane wejściowe dla procesu kompilacji. W elemecie ItemGroupmoże występować zero lub więcej Item elementów.

Oprócz elementu ogólnego Item element ItemGroup umożliwia elementom podrzędnym reprezentującym typy elementów, takich jak Reference, ProjectReference, Compilei inne, jak wymienione w artykule Common MSBuild project items (Wspólne elementy projektu MSBuild).

Elementy nadrzędne

Element opis
Projekt Wymagany element główny pliku projektu MSBuild.
Obiekt docelowy Począwszy od programu .NET Framework 3.5, ItemGroup element może pojawić się wewnątrz Target elementu. Aby uzyskać więcej informacji, zobacz Cele.

Przykład

Poniższy przykład kodu przedstawia kolekcje elementów zdefiniowanych Res przez użytkownika i CodeFiles zadeklarowane wewnątrz ItemGroup elementu. Każdy element w Res kolekcji elementów zawiera element ItemMetadata zdefiniowany przez użytkownika.

<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>

W prostym pliku projektu zwykle używasz jednego ItemGroup elementu, ale można również użyć wielu ItemGroup elementów. W przypadku użycia wielu ItemGroup elementów elementy są łączone w jeden ItemGroupelement . Na przykład niektóre elementy mogą być dołączane przez oddzielny ItemGroup element zdefiniowany w zaimportowanym pliku.

Grupy elementów mogą mieć zastosowane warunki przy użyciu atrybutu Condition . W takim przypadku elementy są dodawane tylko do listy elementów, jeśli warunek jest spełniony. Zobacz warunki programu MSBuild

Atrybut Label jest używany w niektórych systemach kompilacji jako sposób kontrolowania zachowań kompilacji. Można go używać tylko w deklaracjach, jako sposób tworzenia bardziej zrozumiałych skryptów MSBuild lub jako ustawienia kontrolki, aby wpłynąć na akcje kompilacji.

Zobacz też