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>