Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Регистрирует в журнале предупреждение в процессе сборки на основе вычисленного условного оператора.
Параметры
В следующей таблице приводятся параметры задачи Warning.
| Параметр | Описание |
|---|---|
Code |
Необязательный параметр String.Код предупреждения для связи с предупреждением. |
File |
Необязательный параметр String.Указывает соответствующий файл (при его наличии). Если файл не указан, используется файл, содержащий задачу Warning. |
HelpKeyword |
Необязательный параметр String.Ключевое слово справки для связи с предупреждением. Только для внутреннего пользования. |
HelpLink |
Необязательный параметр String.Ссылка на дополнительные сведения о предупреждении. |
Text |
Необязательный параметр String.Текст предупреждения, регистрируемый в журнале MSBuild, если результат вычисления параметра Condition оказывается равным true. |
Замечания
Задача Warning позволяет проектам MSBuild проверять наличие необходимой конфигурации или необходимого свойства перед переходом к следующему шагу сборки.
Если параметр Condition задачи Warning равен true, значение параметра Text записывается в журнал, а процесс сборки продолжается. Если параметр Condition не существует, текст предупреждения записывается в журнал. Дополнительные сведения см. в статье о получении журналов сборки.
Помимо перечисленных выше параметров, эта задача наследует параметры от класса TaskExtension, который, в свою очередь, наследует от класса Task. Список этих дополнительных параметров и их описания см. в статье Базовый класс TaskExtension.
HelpKeyword используется Visual Studio для поддержки функции контекстной справки (F1). С помощью HelpLink можно связать страницу справки в Интернете с сообщением об ошибке.
Пример
Следующий пример кода проверяет свойства, заданные в командной строке. Если заданные свойства отсутствуют, проект инициирует событие предупреждения и регистрирует в журнале значение параметра Text задачи Warning.
<Project>
<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>