ToolTaskExtension – základní třída

  • Článek

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 IBuildEngineIBuildEngine2.
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.

Viz také