Message 任务

在生成期间记录消息。

参数

下表描述了 Message 任务的参数。

Parameter

说明

Importance

可选 String 参数。

指定消息的重要性。 此参数的值可以为 highnormallow。 默认值为 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>

请参见

概念

用 MSBuild 获取生成日志

其他资源

MSBuild 任务参考