Warning 任务

根据计算的条件语句在生成期间记录警告。

参数

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

Parameter

说明

Code

可选 String 参数。

要与警告相关联的警告代码。

File

可选 String 参数。

指定相关文件(如果有)。 如果未提供任何文件,则将使用包含“警告”任务的文件。

HelpKeyword

可选 String 参数。

与警告关联的“帮助”关键字。

Text

可选 String 参数。

Condition 参数的计算结果为 true 时,MSBuild 记录的警告文本。

备注

Warning 任务使 MSBuild 项目可以在继续下一个生成步骤之前,先检查必需的配置或属性是否存在。

Warning 任务的 Condition 参数的计算结果为 true 时,将记录 Text 参数的值,并继续执行生成操作。 如果 Condition 参数不存在,则记录警告文本。 有关日志记录的更多信息,请参见 用 MSBuild 获取生成日志

除了上面列出的参数,此任务还将从 TaskExtension 类继承参数,此类本身从 Task 类继承。 有关这些附加参数及其说明的列表,请参见 TaskExtension 基类

示例

下面的代码示例检查在命令行上设置的属性。 如果未设置任何属性,则项目将引发警告事件,并记录 Warning 任务的 Text 参数的值。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="ValidateCommandLine">
        <Warning
            Text=" The 0 property was not set on the command line."
            Condition="'$(0)' == ''" />
        <Warning
            Text=" The FREEBUILD property was not set on the command line."
            Condition="'$(FREEBUILD)' == ''" />
    </Target>
    ...
</Project>

请参见

概念

用 MSBuild 获取生成日志

MSBuild 项目文件架构引用