警告工作

更新：2007 年 11 月

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

參數

下列表格說明 Warning 工作的參數。

參數	說明
Code	選擇性 String 參數。 與警告關聯的警告程式碼。
HelpKeyword	選擇性 String 參數。 與警告關聯的說明關鍵字。
Text	選擇性 String 參數。 Condition 參數評估為 true 時，MSBuild 所記錄的警告文字。

備註

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

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

範例

下列程式碼範例會檢查在命令列上設定的屬性。如果沒有設定屬性，專案便會發出警告事件，並記錄 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 專案檔案結構描述參考