Warning 工作

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

參數

下表說明 Warning 工作的參數。

參數	描述
Code	選擇性的 String 參數。 要與警告建立關聯的警告碼。
File	選擇性的 String 參數。 指定相關檔案 (如果有的話)。 如果未提供任何檔案，則會使用包含 Warning 工作的檔案。
HelpKeyword	選擇性的 String 參數。 要與此警告關聯的 Help 關鍵字。 僅限內部使用。
HelpLink	選擇性的 String 參數。 有關警告詳細資訊的連結。
Text	選擇性的 String 參數。 MSBuild 在 Condition 參數評估為 true 時所記錄的警告文字。

備註

Warning 工作允許 MSBuild 專案先檢查是否有必要的組態或屬性，再繼續進行下一個建置步驟。

如果 Warning 工作的 Condition 參數評估為 true，則會記錄 Text 參數的值，而建置會繼續執行。 如果 Condition 參數不存在，則會記錄警告文字。 如需有關記錄的詳細資訊，請參閱取得組建記錄檔。

除了上述所列的參數，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。 如需這些其他參數的清單及其描述，請參閱 TaskExtension 基底類別。

Visual Studio 會使用 HelpKeyword 來支援內容相關說明功能 (F1)。 您可以使用 HelpLink 將線上說明頁面與錯誤訊息產生關聯。

範例

下列程式碼範例會檢查命令列上所設定的屬性。 如果未設定任何屬性，專案就會引發警告事件，並記錄 Warning 工作的 Text 參數值。

<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>

另請參閱

• 取得組建記錄檔
• 專案檔案結構描述參考