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