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 = MetadataValueBeberapa 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" ) |