Bagikan melalui

Tugas kesalahan

  • Artikel

Menghentikan build dan mencatat kesalahan berdasarkan pernyataan kondisional yang dievaluasi.

Parameter

Tabel berikut ini menjelaskan parameter tugas Error.

Parameter Deskripsi
Code Parameter String opsional.

Kode kesalahan untuk dikaitkan dengan kesalahan.
File Parameter String opsional.

Nama file yang berisi kesalahan. Jika tidak ada nama file yang disediakan, file yang berisi tugas Kesalahan akan digunakan.
HelpKeyword Parameter String opsional.

Kata kunci bantuan untuk mengaitkan dengan kesalahan. Hanya untuk penggunaan internal.
HelpLink Parameter String opsional.

Tautan ke informasi selengkapnya tentang peringatan tersebut.
Text Parameter String opsional.

Teks kesalahan yang dicatat MSBuild jika Condition parameter dievaluasi ke true.

Keterangan

Tugas Error ini memungkinkan proyek MSBuild mengeluarkan teks kesalahan ke pencatat dan menghentikan eksekusi build.

Condition Jika parameter mengevaluasi ke true, build dihentikan, dan kesalahan dicatat. Jika parameter Condition tidak ada, kesalahan dicatat dan eksekusi build berhenti. Untuk informasi selengkapnya tentang pengelogan, lihat Mendapatkan log build.

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.

HelpKeyword digunakan oleh Visual Studio untuk mendukung fitur bantuan kontekstual (F1). Anda dapat menggunakan HelpLink untuk mengaitkan halaman bantuan online dengan pesan kesalahan.

Contoh

Contoh kode berikut memverifikasi bahwa semua properti yang diperlukan diatur. Jika tidak diatur, proyek akan memunculkan peristiwa kesalahan, dan mencatat nilai Text parameter Error tugas.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="ValidateCommandLine">
        <Error
            Text=" The 0 property must be set on the command line."
            Condition="'$(0)' == ''" />
        <Error
            Text="The FREEBUILD property must be set on the command line."
            Condition="'$(FREEBUILD)' == ''" />
    </Target>
    ...
</Project>

Baca juga