Condividi tramite

Classe di base ToolTaskExtension

  • Articolo

Molte attività ereditano dalla classe ToolTaskExtension che eredita dalla classe ToolTask, che a sua volta eredita dalla classe Task. Questa catena di ereditarietà aggiunge diversi parametri alle attività che ne derivano. Questi parametri sono elencati in questo documento.

Parametri

Nella tabella seguente vengono descritti i parametri delle classi di base.

Parametro Descrizione
BuildEngine Parametro IBuildEngine facoltativo.

Specifica l'interfaccia del motore di compilazione disponibile per le attività. Il motore di compilazione imposta automaticamente questo parametro per consentire alle attività di richiamarlo.
BuildEngine2 Parametro IBuildEngine2 facoltativo.

Specifica l'interfaccia del motore di compilazione disponibile per le attività. Il motore di compilazione imposta automaticamente questo parametro per consentire alle attività di richiamarlo.

Questa è una proprietà che consente agli autori di attività che ereditano da questa classe di non dovere eseguire il cast da IBuildEngine a IBuildEngine2.
BuildEngine3 Parametro IBuildEngine3 facoltativo.

Specifica l'interfaccia del motore di compilazione fornita dall'host.
EchoOff Parametro bool facoltativo.

Se impostata su true, questa attività passa /Q alla riga di comando di cmd.exe in modo che la riga di comando non venga copiata in stdout.
EnvironmentVariables Parametro di matrice String facoltativo.

Matrice di coppie di variabili di ambiente, separate da segni di uguale. Queste variabili vengono passate all'eseguibile generato in aggiunta a o con override selettivo del blocco di ambiente standard.
ExitCode Parametro di sola lettura di output Int32 facoltativo.

Specifica il codice di uscita fornito dal comando eseguito. Se l'attività ha registrato errori, ma il processo ha un codice di uscita pari a 0 (esito positivo), il parametro viene impostato su -1.
HostObject Parametro ITaskHost facoltativo.

Specifica l'istanza dell'oggetto host (può essere null). Il motore di compilazione imposta questa proprietà se l'IDE host ha associato un oggetto host a questa particolare attività.
Log Parametro di sola lettura TaskLoggingHelper facoltativo.

Ottiene un'istanza di una classe TaskLoggingHelperExtension che contiene metodi di registrazione delle attività.
LogStandardErrorAsError Parametro bool facoltativo.

Se true, tutti i messaggi ricevuti nel flusso di errori standard vengono registrati come errori.
StandardErrorImportance Parametro String facoltativo.

Importanza con cui registrare il testo dal flusso di output standard.
StandardOutputImportance Parametro String facoltativo.

Importanza con cui registrare il testo dal flusso di output standard.
Timeout Parametro virtuale Int32 facoltativo.

Specifica la quantità di tempo, in millisecondi, dopo i quali l'eseguibile dell'attività viene terminato. Il valore predefinito è Int.MaxValue, con cui si indica che non esiste alcun periodo di timeout. Il timeout è espresso in millisecondi.
ToolExe Parametro virtuale string facoltativo.

I progetti possono implementarlo per eseguire l'override di un ToolName. Le attività possono eseguirne l'override per conservare il ToolName.
ToolPath Parametro string facoltativo.

Specifica la posizione da cui l'attività carica il file eseguibile sottostante. Se questo parametro non viene specificato, l'attività usa il percorso di installazione dell'SDK corrispondente alla versione del framework che esegue MSBuild.
UseCommandProcessor Parametro bool facoltativo.

Se true, questa attività crea un file batch per la riga di comando e lo esegue mediante il processore dei comandi anziché eseguire direttamente il comando.
YieldDuringToolExecution Parametro bool facoltativo.

Se true, questa attività restituisce il nodo quando l'attività è in esecuzione.

Vedi anche