共用方式為

Message 工作

  • 發行項

在建置期間記錄訊息。

參數

下表說明 Message 工作的參數。

參數 描述
Importance 選擇性的 String 參數。

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

要記錄的錯誤文字。

備註

Message 工作可讓 MSBuild 專案在建置流程各個步驟期間將訊息發送到記錄器。

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

根據預設，訊息會傳送至所有已註冊的記錄器。 記錄器會解譯 Importance 參數。 通常，當記錄器詳細資訊設定為 LoggerVerbosity 時，就會傳送設定為 high 的訊息。Minimal 或更高版本。 當記錄器詳細資訊設為 LoggerVerbosity 時，會傳送設為 low 的訊息。Detailed。

除了上述所列的參數，此項工作還會繼承 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>

另請參閱