Message task
Logs a message during a build.
Parameters
The following table describes the parameters of the Message
task.
Parameter | Description |
---|---|
Importance |
Optional String parameter.Specifies the importance of the message. This parameter can have a value of high , normal or low . The default value is normal . |
Text |
Optional String parameter.The error text to log. |
Remarks
The Message
task allows MSBuild projects to issue messages to loggers at different steps in the build process.
If the Condition
parameter evaluates to true
, the value of the Text
parameter will be logged and the build will continue to execute. If a Condition
parameter does not exist, the message text is logged. For more information on logging, see Obtain build logs.
By default, the message is sent to all registered loggers. The logger interprets the Importance
parameter. Typically, a message set to high
is sent when logger verbosity is set to LoggerVerbosity.Minimal
or higher. A message set to low
is sent when logger verbosity is set to LoggerVerbosity.Detailed
.
In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task 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>