Message タスク
ビルド中のメッセージをログに記録します。
パラメーター
Message タスクのパラメーターの説明を次の表に示します。
パラメーター |
Description |
|---|---|
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>