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


Базовый класс ToolTaskExtension

Многие задачи наследуются от класса ToolTaskExtension, который наследуется от класса ToolTask, который наследуется от класса Task.Эта цепочка наследований добавляет несколько параметров для задач, которые являются производными от них.Эти параметры перечислены в настоящем документе.

Параметры

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

Параметр

Описание

BuildEngine

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

Задает имя интерфейса подсистемы построения, который доступен для задач.Подсистема построения автоматически устанавливает этот параметр, чтобы разрешить задачам обратный вызов.

BuildEngine2

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

Задает имя интерфейса подсистемы построения, который доступен для задач.Подсистема построения автоматически устанавливает этот параметр, чтобы разрешить задачам обратный вызов.

Это удобное свойство; значение авторов задачи, унаследованное от этого класса, не должно быть приведено из IBuildEngine к IBuildEngine2.

BuildEngine3

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

Указывает интерфейс обработчика построения, предоставляемый хостом.

EchoOff

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

Если значение true, эта задача передает /Q командной строке cmd.exe, таким образом, чтобы командная строка не копировалась в stdout.

EnvironmentVariables

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

Массив пар из переменных окружения, разделенных знаками равенства.Эти переменные должны быть переданы в созданный исполняемый файл в дополнение к обычному блоку среды (или частично переопределяя его).

ExitCode

Необязательный Int32 выходной параметр, доступный только для чтения.

Задает код выхода, возвращаемый выполняемой командой.Если задача занесла в журнал ошибки, но процесс имеет код выхода 0 (успешно), значение задается равным -1.

HostObject

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

Указывает экземпляр объекта сайта (может быть пустым).Подсистема построения задает это свойство, если с данной задачей связан объект узла в интегрированной среде разработки (IDE) узла.

Log

Необязательный параметр TaskLoggingHelper, предназначенный только для чтения.

Получает экземпляр класса TaskLoggingHelperExtension, содержащего методы ведения журналов для задачи.

LogStandardErrorAsError

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

Если true, все сообщения, полученные в стандартном потоке ошибок, регистрируются как ошибки.

StandardErrorImportance

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

Степень важности, с которой текст из стандартного потока вывода регистрируется в журнале.

StandardOutputImportance

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

Степень важности, с которой текст из стандартного потока вывода регистрируется в журнале.

Timeout

Виртуальный необязательный параметр Int32.

Указывает временной интервал в миллисекундах, по истечении которого исполнение файла задачи останавливается.Значение по умолчанию Int.MaxValue указывает, что таймаут не задан. Значение таймаута измеряется в миллисекундах.

ToolExe

Виртуальный необязательный параметр string.

Проекты могут использовать это для переопределения ToolName.Задачи могут переопределять это для сохранения ToolName.

ToolPath

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

Указывает расположение, откуда задачей загружается базовый исполняемый файл.Если значение этого параметра не задано, используется путь установки пакета SDK, соответствующий версии среды, в которой выполняется MSBuild.

UseCommandProcessor

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

Если значение true, эта задача создает пакетный файл для командной строки и выполняет его с помощью процессора команд вместо выполнения команды напрямую.

YieldDuringToolExecution

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

Если значение true, эта задача получает узел при выполнении его задачи.

См. также

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

Задачи MSBuild

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

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