Message タスクMessage Task

ビルド中のメッセージをログに記録します。Logs a message during a build.

パラメーターParameters

Message タスクのパラメーターの説明を次の表に示します。The folowing table describes the parameters of the Message task.

パラメーターParameter 説明Description
Importance 省略可能な String 型のパラメーターです。Optional String parameter.

メッセージの重要度を指定します。Specifies the importance of the message. このパラメーターの値には、highnormal、または low を指定できます。This parameter can have a value of high, normal or low. 既定値は normal です。The default value is normal.
Text 省略可能な String 型のパラメーターです。Optional String parameter.

ログに記録するエラー テキスト。The error text to log.

コメントRemarks

Message タスクを使用すると、MSBuildMSBuild プロジェクトで、ビルド処理のさまざまな段階でロガーにメッセージを発行できます。The Message task allows MSBuildMSBuild projects to issue messages to loggers at different steps in the build process.

Condition パラメーターが true と評価されると、Text パラメーターの値がログに記録され、ビルド処理が継続されます。If the Condition parameter evaluates to true, the value of the Text parameter will be logged and the build will continue to execute. Condition パラメーターが存在しない場合は、メッセージ テキストがログに記録されます。If a Condition parameter does not exist, the message text is logged. ログ処理の詳細については、ビルド ログの取得に関するページを参照してください。For more information on logging, see Obtaining Build Logs.

既定では、メッセージは MSBuild のコンソール ロガーに送信されます。By default, the message is sent to the MSBuild console logger. これは、Log プロパティを設定することにより変更できます。This can be changed by setting the Log parameter. ロガーによって Importance パラメーターが解釈されます。The logger interprets the Importance parameter.

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. これらの追加のパラメーターの一覧とその説明については、「 TaskExtension Base Class」を参照してください。For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

Example

次のコード例は、登録されているすべてのロガーにメッセージをログ記録します。The following code example logs messages to all registered loggers.

<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>  

関連項目See Also

Task Reference (タスク リファレンス) Task Reference
ビルド ログの取得Obtaining Build Logs