Bagikan melalui

Tugas peringatan

  • Artikel

Mencatat peringatan selama build berdasarkan pernyataan kondisional yang dievaluasi.

Parameter

Tabel berikut ini menjelaskan parameter tugas Warning.

Parameter Deskripsi
Code Parameter String opsional.

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

Menentukan file yang relevan, jika ada. Jika tidak ada file yang disediakan, file yang berisi tugas Peringatan akan digunakan.
HelpKeyword Parameter String opsional.

Kata kunci Bantuan untuk dikaitkan dengan peringatan. Hanya untuk penggunaan internal.
HelpLink Parameter String opsional.

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

Teks peringatan yang dicatat MSBuild jika parameter Condition dievaluasi menjadi true.

Keterangan

Tugas Warning memungkinkan proyek MSBuild untuk memeriksa keberadaan konfigurasi atau properti yang diperlukan sebelum melanjutkan dengan langkah build berikutnya.

Jika parameter Condition dari tugas Warning dievaluasi menjadi true, nilai parameter Text dicatat dan build terus dijalankan. Jika parameter Condition tidak ada, teks peringatan akan dicatat. 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 memeriksa properti yang diatur pada baris perintah. Jika tidak ada properti yang ditetapkan, proyek akan memunculkan peristiwa peringatan, dan mencatat nilai parameter Text dari tugas Warning.

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

Baca juga