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 |
Oggetto di descrizione |
|---|---|
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. |
|
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. |
|
Parametro IBuildEngine3 facoltativo. Specifica l'interfaccia del motore di compilazione fornita dall'host. |
|
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. |
|
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. |
|
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. |
|
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à. |
|
Parametro di sola lettura TaskLoggingHelper facoltativo. Ottiene un'istanza della classe TaskLoggingHelperExtension in cui sono contenuti i metodi di registrazione delle attività. |
|
Parametro bool facoltativo. Se true, tutti i messaggi ricevuti nel flusso di errori standard vengono registrati come errori. |
|
Parametro String facoltativo. Importanza con cui registrare il testo dal flusso di output standard. |
|
Parametro String facoltativo. Importanza con cui registrare il testo dal flusso di output standard. |
|
Parametro Int32 virtuale facoltativo. Specifica l'intervallo di tempo, in millisecondi, al termine del quale l'eseguibile dell'attività viene interrotto. Il valore predefinito è Int.MaxValue, per indicare che non è stato specificato alcun periodo di timeout. Il timeout viene fornito in millisecondi. |
|
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. |
|
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. |
|
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. |
|
Parametro bool facoltativo. Se impostato su true viene restituito il nodo quando la relativa attività è in esecuzione. |