Compartir a través de


ToolTaskExtension (Clase base)

Muchas de las tareas heredan de la clase ToolTaskExtension, que hereda de la clase ToolTask, que a su vez hereda de la clase Task. Esta cadena de herencia agrega varios parámetros a las tareas que derivan de ellos. Estos parámetros se enumeran en este documento.

Parámetros

En la siguiente tabla se describen los parámetros de las clases base.

Parámetro

Descripción

BuildEngine

Parámetro IBuildEngine opcional.

Especifica la interfaz de motor de compilación disponible para las tareas. El motor de compilación establece automáticamente este parámetro para que las tareas puedan volver a llamarla.

BuildEngine2

Parámetro IBuildEngine2 opcional.

Especifica la interfaz de motor de compilación disponible para las tareas. El motor de compilación establece automáticamente este parámetro para que las tareas puedan volver a llamarla.

Se trata de una propiedad de conveniencia para que los autores de tareas que hereden de esta clase no tengan que convertir el valor de IBuildEngine en IBuildEngine2.

BuildEngine3

Parámetro IBuildEngine3 opcional.

Especifica la interfaz de motor de compilación proporcionada por el host.

EchoOff

Parámetro bool opcional.

Cuando se establece en true, esta tarea pasa /Q a la línea de comandos de cmd.exe de forma que la línea de comandos no se copia en stdout.

EnvironmentVariables

Parámetro de matriz String opcional.

Matriz de pares de variables de entorno, separadas por signos igual. Estas variables se pasan al ejecutable generado además de, o invalidando selectivamente, el bloque de entorno regular.

ExitCode

Parámetro de salida de sólo lectura Int32 opcional.

Especifica el código de salida proporcionado por el comando ejecutado. Si la tarea registra errores, pero el proceso tenía un código de salida de 0 (correcto), esto se establece en -1.

HostObject

Parámetro ITaskHost opcional.

Especifica la instancia del objeto host (puede ser null). El motor de generación establece esta propiedad si el entorno IDE del host tiene un objeto host asociado a esta tarea concreta.

Log

Parámetro de solo lectura TaskLoggingHelper opcional.

Obtiene una instancia de una clase TaskLoggingHelperExtension que contiene métodos de registro de tareas.

LogStandardErrorAsError

Parámetro bool opcional.

Si es true, todos los mensajes recibidos en el flujo de error estándar se registran como errores.

StandardErrorImportance

Parámetro String opcional.

Importancia con la que se va a registrar el texto del flujo de salida estándar.

StandardOutputImportance

Parámetro String opcional.

Importancia con la que se va a registrar el texto del flujo de salida estándar.

Timeout

Parámetro Int32 opcional virtual.

Especifica el tiempo, en milisegundos, tras el cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue; es decir, no existe tiempo de espera. El intervalo de tiempo de espera es en milisegundos.

ToolExe

Parámetro string opcional virtual.

Los proyectos pueden implementarlo para invalidar ToolName. Las tareas pueden invalidar esto para preservar ToolName.

ToolPath

Parámetro string opcional.

Especifica la ubicación desde la que la tarea carga el archivo ejecutable subyacente. Si no se especifica este parámetro, la tarea utiliza la ruta de acceso de instalación del SDK correspondiente a la versión de Framework que está ejecutando MSBuild.

UseCommandProcessor

Parámetro bool opcional.

Cuando se establece en true, esta tarea crea un archivo por lotes para la línea de comandos y lo ejecuta utilizando el procesador de comandos en lugar de ejecutar el comando directamente.

YieldDuringToolExecution

Parámetro bool opcional.

Cuando se establece en true, esta tarea produce el nodo durante la ejecución de su tarea.

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild