Elemen tugas Target (MSBuild)

Artikel
08/25/2023

Membuat dan menjalankan instans dari tugas MSBuild. Nama elemen ditentukan oleh nama tugas yang sedang dibuat.

Sintaks

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

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.
`ContinueOnError`	Atribut opsional. Dapat berisi salah satu nilai berikut: - WarnAndContinue atau true. Ketika tugas gagal, tugas berikutnya dalam elemen Target dan build terus dijalankan, dan semua kesalahan dari tugas diperlakukan sebagai peringatan. - ErrorAndContinue. Ketika tugas gagal, tugas berikutnya dalam elemen `Target` dan build terus dijalankan, dan semua kesalahan dari tugas tersebut dianggap sebagai peringatan. - ErrorAndStop atau salah (default). Ketika tugas gagal, tugas yang tersisa dalam elemen `Target` dan build tidak berjalan, dan seluruh elemen `Target` dan buildnya dianggap gagal. Versi .NET Framework sebelum 4.5 hanya mendukung nilai `true` dan `false`. Untuk informasi selengkapnya, lihat Cara: Mengabaikan kesalahan dalam tugas.
`Parameter`	Diperlukan jika kelas tugas berisi satu properti atau lebih berlabel `[Required]` atribut. Parameter tugas yang ditentukan pengguna yang berisi nilai parameter sebagai nilainya. Mungkin ada sejumlah parameter dalam `Task` elemen , dengan setiap pemetaan atribut ke properti .NET di kelas tugas.

Elemen anak

Elemen	Deskripsi
Hasil	Menyimpan output dari tugas dalam file proyek. Mungkin ada nol atau lebih `Output` elemen dalam tugas.

Elemen induk

Elemen	Deskripsi
Target	Elemen kontainer untuk tugas MSBuild.

Keterangan

Task Elemen dalam file proyek MSBuild membuat instans tugas, mengatur properti di dalamnya, dan menjalankannya. Elemen Output menyimpan parameter output dalam properti atau item yang akan digunakan di tempat lain dalam file proyek.

Jika ada elemen OnError dalam elemen induk Target tugas, elemen tersebut masih akan dievaluasi jika tugas gagal dan ContinueOnError memiliki nilai false. Untuk informasi selengkapnya tentang tugas, lihat Tugas.

Contoh

Contoh kode berikut membuat instans kelas tugas Csc, menetapkan enam properti, dan menjalankan tugas. Setelah eksekusi, nilai OutputAssembly properti objek ditempatkan ke dalam daftar item bernama FinalAssemblyName.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

Share via