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 项目文件架构引用