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>