Message 任务
在生成期间记录消息。
参数
下表描述了 Message 任务的参数。
Parameter |
说明 |
---|---|
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>