Compartilhar via


Classe ToolTaskExtension (base)

Muitas tarefas herdam o ToolTaskExtension classe, que herda a ToolTask herda de classe, que por si só a Task classe. Esta cadeia de herança adiciona vários parâmetros para as tarefas que derivam delas. Esses parâmetros são listados neste documento.

Parâmetros

A tabela a seguir descreve os parâmetros das classes base.

Parâmetro

Descrição

BuildEngine

Opcional IBuildEngine parâmetro.

Especifica a interface de mecanismo de compilação disponível para tarefas. O mecanismo de compilação automaticamente define este parâmetro para permitir que tarefas de retorno de chamada para ela.

BuildEngine2

Opcional IBuildEngine2 parâmetro.

Especifica a interface de mecanismo de compilação disponível para tarefas. O mecanismo de compilação automaticamente define este parâmetro para permitir que tarefas de retorno de chamada para ela.

Esta é uma propriedade de conveniência para que os autores de tarefa herdam essa classe não é necessário converter o valor de IBuildEngine para IBuildEngine2.

BuildEngine3

Opcional IBuildEngine3 parâmetro.

Especifica a interface do mecanismo de compilação fornecida pelo host.

EchoOff

Opcional bool parâmetro.

Quando definido como true, este passa a tarefa /Q para o cmd. exe comando de linha de modo que a linha de comando não é copiada para stdout.

EnvironmentVariables

Opcional String parâmetro de matriz.

Matriz de pares de variáveis de ambiente, separadas por sinais de igual. Essas variáveis são passadas para o executável gerado além ou substituição de forma seletiva, o bloco de ambiente regular.

ExitCode

Opcional Int32 somente leitura parâmetro de saída.

Especifica o código de saída fornecida pelo comando executado. Se a tarefa registrada quaisquer erros, mas o processo teve um código de saída 0 (sucesso), isso é definido como -1.

HostObject

Opcional ITaskHost parâmetro.

Especifica a instância do objeto de host (pode ser nulo). O mecanismo de compilação define essa propriedade se o host IDE tiver associado um objeto de host com essa tarefa específica.

Log

Opcional TaskLoggingHelper parâmetro somente leitura.

Obtém uma instância de um TaskLoggingHelperExtension classe que contém os métodos de log da tarefa.

LogStandardErrorAsError

Opção bool parâmetro.

Se true, todas as mensagens recebidas no fluxo de erro padrão são registradas como erros.

StandardErrorImportance

Opcional String parâmetro.

Importância para fazer o logon de texto do padrão para fora do fluxo.

StandardOutputImportance

Opcional String parâmetro.

Importância para fazer o logon de texto do padrão para fora do fluxo.

Timeout

Virtual opcional Int32 parâmetro.

Especifica a quantidade de tempo, em milissegundos, após o qual a tarefa executável é encerrada. O valor padrão é Int.MaxValue, indicando que não há nenhum período de tempo limite.É de tempo limite em milissegundos.

ToolExe

Virtual opcional string parâmetro.

Projetos podem ser implementado para substituir um nome da ferramenta. As tarefas podem substituir esta opção para preservar o nome da ferramenta.

ToolPath

Opcional string parâmetro.

Especifica o local de onde a tarefa carrega o arquivo executável subjacente. Se este parâmetro não for especificado, a tarefa usa o caminho de instalação do SDK que corresponde à versão do framework que está executando o MSBuild.

UseCommandProcessor

Opcional bool parâmetro.

Quando definido como true, esta tarefa cria um arquivo de lote da linha de comando e o executa usando o processador de comandos em vez de executar o comando diretamente.

YieldDuringToolExecution

Opcional bool parâmetro.

Quando definido como true, esta tarefa gera o nó quando a tarefa está em execução.

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência das tarefas do MSBuild