訊息工作

  • 發行項

在建置期間記錄訊息。

參數

下表說明 Message 工作的參數。

參數

描述

Importance

選擇性 String 參數。

指定訊息的重要性。這個參數可以具有 high、normal 或 low 的值。預設值是 normal。

Text

選擇性 String 參數。

要記錄的錯誤文字。

備註

Message 工作允許 MSBuild 專案對建置處理序中不同步驟的記錄器發出訊息。

如果 Condition 參數評估為 true，就會記錄 Text 參數的值，並且繼續執行建置。如果 Condition 屬性並不存在，就會記錄訊息文字。如需記錄的詳細資訊，請參閱 使用 MSBuild 取得建置記錄。

訊息預設會傳送至 MSBuild 主控台記錄器。這可以藉由設定 Log 參數來變更。記錄器會解譯 Importance 參數。

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

範例

下列程式碼範例會將訊息記錄到所有已註冊的記錄器。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="DisplayMessages">
        <Message Text="Project File Name = $(MSBuildProjectFile)" />
        <Message Text="Project Extension = $(MSBuildProjectExtension)" />
    </Target>
    ...
</Project>

請參閱

概念

使用 MSBuild 取得建置記錄

其他資源

MSBuild 工作參考