Message 任务

在生成期间记录消息。

参数

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

参数 说明
Importance 可选 String 参数。

指定消息的重要性。 此参数的值可以是 highnormallow。 默认值为 normal
Text 可选 String 参数。

要记录的错误文本。

注解

通过 Message 任务,MSBuild 项目可以在生成过程中的不同阶段将消息发送到记录器中。

如果 Condition 参数的计算结果为 true,则将会记录 Text 参数值,并继续执行生成。 如果 Condition 参数不存在,则将记录消息文本。 有关日志记录的详细信息,请参阅获取生成日志

默认情况下,消息将发送到所有已注册的记录器。 记录器解释 Importance 参数。 通常,当记录器详细级别设置为 LoggerVerbosity Minimal 时,将发送设置为 high 的消息。 或更高版本。 当记录器详细级别设置为 LoggerVerbosity Detailed 时,将发送设置为 low 的消息。

除上面列出的参数外,此任务还从 TaskExtension 类继承参数,后者自身继承自 Task 类。 有关这些其他参数的列表及其说明的信息,请参阅 TaskExtension 基类

示例

下面的代码示例将消息记录到所有已注册的记录器。

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

另请参阅