Warning 任务

更新：2007 年 11 月

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

参数

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

参数	说明
Code	可选的 String 参数。 要与警告相关联的警告代码。
HelpKeyword	可选的 String 参数。 要与警告相关联的帮助关键字。
Text	可选的 String 参数。 当 Condition 参数的计算结果为 true 时，MSBuild 记录的警告文本。

备注

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

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

示例

下面的代码示例检查在命令行上设置的属性。如果未设置任何属性，则项目将引发警告事件，并记录 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 项目文件架构引用