Tugas CreateItem

Mengisi koleksi item dengan item input. Ini memungkinkan item disalin dari satu daftar ke daftar lainnya.

Catatan

Tugas ini tidak digunakan lagi. Dimulai dengan .NET Framework 3.5, grup item dapat ditempatkan dalam elemen Target. Untuk informasi selengkapnya, lihat Item.

Atribut

Tabel berikut ini menjelaskan parameter tugas CreateItem.

Parameter	Deskripsi
AdditionalMetadata	Parameter array String opsional. Menentukan metadata tambahan untuk dilampirkan ke item output. Tentukan nama dan nilai metadata untuk item dengan sintaks berikut: MetadataName=MetadataValue Beberapa pasangan nama/nilai metadata harus dipisahkan dengan titik koma. Jika nama atau nilai berisi titik koma atau karakter khusus lainnya, nama atau nilai tersebut harus diloloskan. Untuk informasi selengkapnya, lihat Cara: Menghindari karakter khusus di MSBuild.
Exclude	Parameter output ITaskItem[] opsional. Menentukan item yang akan dikecualikan dari set item output. Parameter ini dapat berisi spesifikasi wildcard. Untuk informasi selengkapnya, lihat Item dan Cara: Mengecualikan file dari build.
Include	Parameter ITaskItem[] wajib. Menentukan item yang akan disertakan dalam set item output. Parameter ini dapat berisi spesifikasi wildcard.
PreserveExistingMetadata	Parameter Boolean opsional. Jika True, hanya menerapkan metadata tambahan jika belum ada.

Keterangan

Selain parameter yang tercantum di atas, tugas ini mewarisi parameter dari kelas TaskExtension, yang mewarisi sendiri dari kelas Task. Untuk daftar parameter tambahan ini dan deskripsinya, lihat kelas dasar TaskExtension.

Contoh

Contoh kode berikut membuat koleksi item baru bernama MySourceItemsWithMetadata dari koleksi item MySourceItems. Tugas CreateItem mengisi koleksi item baru dengan item dalam item MySourceItems. Kemudian menambahkan entri metadata tambahan bernama MyMetadata dengan nilai Hello untuk setiap item dalam koleksi baru.

Setelah tugas dijalankan, koleksi item MySourceItemsWithMetadata berisi item file1.resx dan file2.resx, keduanya dengan entri metadata untuk MyMetadata. Koleksi item MySourceItems tidak berubah.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <MySourceItems Include="file1.resx;file2.resx" />
    </ItemGroup>

    <Target Name="NewItems">
        <CreateItem
            Include="@(MySourceItems)"
            AdditionalMetadata="MyMetadata=Hello">
           <Output
               TaskParameter="Include"
               ItemName="MySourceItemsWithMetadata"/>
        </CreateItem>

    </Target>

</Project>

Tabel berikut ini menjelaskan nilai item output setelah eksekusi tugas. Metadata item ditampilkan dalam tanda kurung setelah item.

Koleksi item	Konten
MySourceItemsWithMetadata	file1.resx (MyMetadata="Hello") file2.resx (MyMetadata="Hello")

Lihat juga

• Referensi tugas
• Tugas