ToolTaskExtension – základní třída
Mnoho úkolů dědí z ToolTaskExtension třídy, která dědí z ToolTask třídy, která sama dědí z Task třídy. Tento řetěz dědičnosti přidá několik parametrů k úkolům, které jsou z nich odvozeny. Tyto parametry jsou uvedeny v tomto dokumentu.
Parametry
Následující tabulka popisuje parametry základních tříd.
| Parametr | Popis |
|---|---|
| BuildEngine | Volitelný IBuildEngine parametr. Určuje rozhraní modulu sestavení, které je k dispozici pro úlohy. Modul sestavení automaticky nastaví tento parametr tak, aby do něj mohly úkoly volat zpět. |
| BuildEngine2 | Volitelný IBuildEngine2 parametr. Určuje rozhraní modulu sestavení, které je k dispozici pro úlohy. Modul sestavení automaticky nastaví tento parametr tak, aby do něj mohly úkoly volat zpět. Jedná se o vlastnost pohodlí, aby autoři úkolů dědění z této třídy nemuseli přetypovat hodnotu z hodnoty do IBuildEngine IBuildEngine2. |
| BuildEngine3 | Volitelný IBuildEngine3 parametr. Určuje rozhraní modulu sestavení poskytovaného hostitelem. |
| EchoOff | Volitelný bool parametr.Pokud je truetato hodnota nastavena , tento úkol předá příkazový řádek cmd.exe příkazový řádek tak, aby se příkazový řádek nezkopíroval do stdout. |
| EnvironmentVariables | Volitelný String parametr pole.Pole párů proměnných prostředí oddělených znaménky rovná se Tyto proměnné se předávají do vytvářeného spustitelného souboru kromě pravidelného bloku prostředí nebo selektivně přepisují. |
| ExitCode | Volitelný Int32 výstupní parametr jen pro čtení.Určuje ukončovací kód, který poskytuje spuštěný příkaz. Pokud úloha protokolovala nějaké chyby, ale proces měl ukončovací kód 0 (úspěch), je nastaven na hodnotu -1. |
| HostObject | Volitelný ITaskHost parametr. Určuje instanci hostitelského objektu (může mít hodnotu null). Modul sestavení nastaví tuto vlastnost, pokud rozhraní IDE hostitele má přidružen objekt hostitele k této konkrétní úloze. |
| Log | Volitelný TaskLoggingHelper parametr jen pro čtení. Získá instanci TaskLoggingHelperExtension třídy, která obsahuje metody protokolování úloh. |
| LogStandardErrorAsError | Parametr option bool .Pokud truese všechny zprávy přijaté ve standardním chybovém streamu zaprotokolují jako chyby. |
| StandardErrorImportance | Volitelný String parametr.Důležitost, se kterou se má protokolovat text ze standardního výstupního datového proudu |
| StandardOutputImportance | Volitelný String parametr.Důležitost, se kterou se má protokolovat text ze standardního výstupního datového proudu |
| Timeout | Virtuální volitelný Int32 parametr.Určuje dobu v milisekundách, po které se spustitelný soubor úlohy ukončí. Výchozí hodnota znamená Int.MaxValue, že neexistuje žádné časové období. Časový limit je v milisekundách. |
| ToolExe | Virtuální volitelný string parametr.Projekty můžou tuto implementaci implementovat, aby přepsaly ToolName. Úkoly můžou tuto možnost přepsat, aby se zachoval název ToolName. |
| ToolPath | Volitelný string parametr.Určuje umístění, ze kterého úloha načte základní spustitelný soubor. Pokud tento parametr není zadaný, úloha použije instalační cestu sady SDK, která odpovídá verzi architektury, na které běží nástroj MSBuild. |
| UseCommandProcessor | Volitelný bool parametr.Pokud je tato úloha nastavená na truehodnotu , vytvoří pro příkazový řádek dávkový soubor a spustí ho pomocí procesoru příkazů místo přímého spuštění příkazu. |
| YieldDuringToolExecution | Volitelný bool parametr.Pokud je tato hodnota nastavená na true, tento úkol při provádění úkolu získá uzel. |