Elemen ItemGroup (MSBuild)

Artikel
08/25/2023

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

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.

Bagikan melalui