Elemen ItemGroup (MSBuild)

  • Artikel

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

<Project><ItemGroup>

Sintaks

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

Atribut

Atribut Deskripsi
Condition Atribut opsional. Kondisi yang akan dievaluasi. Untuk informasi selengkapnya, lihat Syarat-syarat.
Label Atribut opsional. Mengidentifikasi ItemGroup.

Elemen anak

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

Selain elemen generik Item, ItemGroup memungkinkan elemen turunan yang mewakili tipe item, seperti Reference, ProjectReference, Compile, dan lainnya seperti yang tercantum di item proyek Common MSBuild.

Elemen induk

Elemen Deskripsi
Project Elemen akar yang diperlukan dari file proyek MSBuild.
Target Dimulai dengan .NET Framework 3.5, ItemGroup elemen dapat muncul di dalam Target elemen. Untuk informasi selengkapnya, lihat Target.

Contoh

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

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

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 ItemGroup terpisah yang ditentukan dalam file yang diimpor.

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

Atribut Label ini 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.

Baca juga