Message 工作

在建置期間記錄訊息。

參數

下表說明 Message 工作的參數。

參數 Description
Importance 選擇性的 String 參數。

指定訊息的重要性。 此參數的值可以是 highnormallow。 預設值是 normal
Text 選擇性的 String 參數。

要記錄的錯誤文字。

備註

工作 Message 可讓 MSBuild 專案在建置程式的不同步驟發出訊息給記錄器。

如果 Condition 參數評估為 true,將會記錄 Text 參數的值,而建置將會繼續執行。 如果 Condition 參數不存在,便會記錄訊息文字。 如需有關記錄的詳細資訊,請參閱取得組建記錄檔

根據預設,訊息會傳送至所有已註冊的記錄器。 記錄器會解譯 Importance 參數。 一般而言,當記錄器詳細資訊設定為 時,會傳送設定為 LoggerVerbosity 的訊息 high 集。Minimal 或更新版本。 當記錄器詳細資訊設定為 時,會傳送設定為 LoggerVerbosityDetailed 的訊息 low

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

範例

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

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

另請參閱