警告工作

在建置期間根據評估的條件陳述式記錄警告。

參數

下表說明 Warning 工作的參數。

參數	描述
Code	選擇性 String 參數。 與警告關聯的警告程式碼。
File	選擇性 String 參數。 指定相關的檔案 (如果有的話)。如果未提供任何檔案，則會使用 Warning 工作。
HelpKeyword	選擇性 String 參數。 要與警告產生關聯的 Help 關鍵字。
Text	選擇性 String 參數。 Condition 參數評估為 true 時，MSBuild 所記錄的警告文字。

備註

Warning 工作可以讓 MSBuild 專案在進行下一個建置步驟之前，檢查必要的組態或屬性 (Property) 是否存在。

如果 Warning 工作的 Condition 參數評估為 true，則會記錄 Text 參數的值並繼續執行建置。如果沒有 Condition 參數，就會記錄警告文字。如需記錄的詳細資訊，請參閱 使用 MSBuild 取得建置記錄。

除了以上列出的參數之外，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。如需這些錯誤碼的清單及其說明，請參閱 TaskExtension 基底類別。

範例

下列程式碼範例會檢查在命令列上設定的屬性。如果沒有設定屬性，專案便會發出警告事件，並記錄 Warning 工作的 Text 參數值。

<Project xmlns="https://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>

請參閱

概念

使用 MSBuild 取得建置記錄

MSBuild 專案檔案結構描述參考