在生成期间记录消息。
参数
下表描述了 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>