Поделиться через


Задача Message

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

Параметры

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

Параметр

Описание

Importance

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

Указывает важность сообщения. Этот параметр может иметь следующие значения: high, normal и low. Значение по умолчанию — normal.

Text

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

Текст ошибки, записываемый в журнал.

Заметки

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

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

По умолчанию сообщение отправляется в средство ведения журнала консоли MSBuild. Это можно изменить, задав параметр Log. Средство ведения журнала интерпретирует параметр Importance.

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

Пример

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

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

См. также

Основные понятия

Общие сведения о средстве ведении журнала в MSBuild

Другие ресурсы

Справочные сведения о задачах MSBuild