Warning - задача

  • Статья

Регистрирует в журнале предупреждение в процессе сборки на основе вычисленного условного оператора.

Параметры

В следующей таблице приводятся параметры задачи 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 xmlns="http://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>

См. также