Elemen ItemGroup (MSBuild)

Berisi sekumpulan elemen Item yang ditentukan pengguna. Setiap item yang digunakan dalam proyek MSBuild harus ditentukan sebagai anak dari ItemGroup elemen.

<Grup Item Proyek><>

Syntax

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

Atribut dan elemen

Bagian berikut menjelaskan atribut, elemen turunan, dan elemen induk.

Attributes

Attribute Description
Condition Atribut opsional. Kondisi yang akan dievaluasi. Untuk informasi selengkapnya, lihat Kondisi.
Label Atribut opsional. ItemGroupMengidentifikasi .

Elemen turunan

Elemen Description
Benda Menentukan input untuk proses build. Mungkin ada nol atau lebih Item elemen dalam ItemGroup.

Selain elemen generikItem, ItemGroup memungkinkan elemen turunan yang mewakili jenis item, seperti Reference, , ProjectReferenceCompile, dan lainnya seperti yang tercantum di item proyek Common MSBuild.

Elemen induk

Elemen Description
Proyek Elemen akar yang diperlukan dari file proyek MSBuild.
Target Elemen ItemGroup dapat muncul di dalam Target elemen. Untuk informasi selengkapnya, lihat Target.

Example

Contoh kode berikut menunjukkan koleksi Res item yang ditentukan pengguna dan CodeFiles dideklarasikan di dalam ItemGroup elemen. Setiap item dalam Res kumpulan item berisi elemen ItemMetadata anak yang ditentukan pengguna.

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

Dalam file proyek sederhana, Anda biasanya menggunakan satu ItemGroup elemen, tetapi Anda juga dapat menggunakan beberapa ItemGroup elemen. Saat beberapa ItemGroup elemen digunakan, item digabungkan menjadi satu ItemGroup. Misalnya, beberapa item mungkin disertakan oleh elemen terpisah ItemGroup yang ditentukan dalam file yang diimpor.

ItemGroups dapat memiliki kondisi yang diterapkan dengan menggunakan Condition atribut . Dalam hal ini, item hanya ditambahkan ke daftar item jika kondisi terpenuhi. Lihat Kondisi MSBuild

Atribut Label digunakan dalam beberapa sistem build sebagai cara untuk mengontrol perilaku build. Anda hanya dapat menggunakannya dalam deklarasi, sebagai cara untuk membuat skrip MSBuild yang lebih dapat dimengerti, atau sebagai pengaturan kontrol untuk memengaruhi tindakan build.

Lihat juga