Condividi tramite


Classe di base ToolTaskExtension

Molte attività ereditano dalla classe ToolTaskExtension che eredita dalla classe ToolTask, che eredita dalla classe Task. Tramite questa catena di ereditarietà vengono aggiunti diversi parametri alle attività da essi derivate. Tali parametri vengono elencati in questo documento.

Parametri

Nella tabella riportata di seguito sono descritti i parametri delle classi di base.

Parametro

Descrizione

BuildEngine

Parametro IBuildEngine facoltativo.

Specifica l'interfaccia del modulo di gestione della compilazione disponibile per le attività. Questo parametro viene impostato automaticamente tramite il motore di compilazione per consentire alle attività di richiamare il motore stesso.

BuildEngine2

Parametro IBuildEngine2 facoltativo.

Specifica l'interfaccia del modulo di gestione della compilazione disponibile per le attività. Questo parametro viene impostato automaticamente tramite il motore di compilazione per consentire alle attività di richiamare il motore stesso.

Si tratta di una proprietà che consente agli autori di attività che ereditano da questa classe di non dover eseguire il cast del valore da IBuildEngine in IBuildEngine2.

BuildEngine3

Parametro IBuildEngine3 facoltativo.

Specifica l'interfaccia del motore di compilazione fornita dall'host.

EchoOff

Parametro bool facoltativo.

Se impostata su true, tramite questa attività l'opzione /Q viene passata alla riga di comando cmd.exe in modo che questa non venga copiata in stdout.

EnvironmentVariables

Parametro matrice String facoltativo.

Matrice di coppie di variabili di ambiente, separate da segni di uguale. Tali variabili vengono passate all'eseguibile compilato in aggiunta al blocco di ambiente regolare oppure eseguendo l'override selettivo di tale blocco.

ExitCode

Parametro di output di sola lettura Int32 facoltativo.

Specifica il codice di uscita fornito dal comando eseguito. Se per l'attività sono stati registrati degli errori, ma il codice di uscita del processo è 0 (esito positivo), questo parametro è 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 dell'host ha un oggetto host associato con questa particolare attività.

Log

Parametro di sola lettura TaskLoggingHelper facoltativo.

Ottiene un'istanza della classe TaskLoggingHelperExtension in cui sono contenuti i 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 Int32 virtuale facoltativo.

Specifica l'intervallo di tempo, in millisecondi, al termine del quale l'eseguibile dell'attività verrà interrotto. Il valore predefinito è Int.MaxValue, per indicare che non è stato specificato alcun periodo di timeout. Il timeout viene fornito in millisecondi.

ToolExe

Parametro string virtuale facoltativo.

È possibile che questo parametro venga implementato per eseguire l'override di un ToolName. È possibile che tramite le attività venga eseguito l'override di questo parametro per conservare ToolName.

ToolPath

Parametro string facoltativo.

Specifica il percorso utilizzato dall'attività per caricare il file eseguibile sottostante. Se questo parametro non è specificato, viene utilizzato il percorso di installazione SDK corrispondente alla versione del framework che esegue MSBuild.

UseCommandProcessor

Parametro bool facoltativo.

Se impostata su true, questa attività consente di creare un file batch per la riga di comando che viene eseguito mediante il processore dei comandi invece di eseguire il comando direttamente.

YieldDuringToolExecution

Parametro bool facoltativo.

Se impostato su true viene restituito il nodo quando la relativa attività è in esecuzione.

Vedere anche

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild