Message - задача

  • Статья

Записывает сообщения в журнал в процессе сборки.

Параметры

В следующей таблице приводятся параметры задачи Message.

Параметр Описание
Importance Необязательный параметр String.

Определяет важность сообщения. Этот параметр может иметь значение high, normal или low. Значение по умолчанию — normal.
Text Необязательный параметр String.

Текст ошибки для записи в журнал.

Замечания

Задача Message позволяет проектам MSBuild отправлять сообщения в средства ведения журнала на разных этапах процесса сборки.

Если параметр Condition равен true, значение параметра Text записывается, а процесс сборки продолжает выполняться. Если параметр Condition не существует, текст сообщения записывается в журнал. Дополнительные сведения см. в статье о получении журналов сборки.

По умолчанию сообщение отправляется во все зарегистрированные средства ведения журнала. Средство ведения журнала интерпретирует параметр Importance. Как правило, набор high сообщений отправляется при настройке LoggerVerbosityдетализации средства ведения журнала.Minimal или более поздней версии. Сообщение со свойством low отправляется, если для детализации средства ведения журнала задано значение LoggerVerbosity.Detailed.

Помимо перечисленных выше параметров, эта задача наследует параметры от класса TaskExtension, который, в свою очередь, наследует от класса Task. Список этих дополнительных параметров и их описания см. в статье Базовый класс TaskExtension.

Пример

В следующем примере кода сообщения регистрируются во всех зарегистрированных средствах ведения журнала.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="DisplayMessages">
        <Message Text="Project File Name = $(MSBuildProjectFile)" />
        <Message Text="Project Extension = $(MSBuildProjectExtension)" />
    </Target>
    ...
</Project>

См. также