ToolTaskExtension, klasa podstawowa
Wiele zadań dziedziczy po ToolTaskExtension klasie, która dziedziczy po ToolTask klasie, która dziedziczy się po Task klasie. Ten łańcuch dziedziczenia dodaje kilka parametrów do zadań, które pochodzą z nich. Te parametry są wymienione w tym dokumencie.
Parametry
W poniższej tabeli opisano parametry klas bazowych.
| Parametr | Opis |
|---|---|
| BuildEngine | Opcjonalny IBuildEngine parametr. Określa interfejs aparatu kompilacji dostępny dla zadań. Aparat kompilacji automatycznie ustawia ten parametr, aby umożliwić wykonywanie wywołań z powrotem do niego zadań. |
| BuildEngine2 | Opcjonalny IBuildEngine2 parametr. Określa interfejs aparatu kompilacji dostępny dla zadań. Aparat kompilacji automatycznie ustawia ten parametr, aby umożliwić wykonywanie wywołań z powrotem do niego zadań. Jest to właściwość wygody, dzięki czemu autorzy zadań dziedziczący z tej klasy nie muszą rzutować wartości z IBuildEngine na IBuildEngine2. |
| BuildEngine3 | Opcjonalny IBuildEngine3 parametr. Określa interfejs aparatu kompilacji dostarczony przez hosta. |
| EchoOff | Opcjonalny bool parametr.Gdy jest ustawiona wartość true, to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do pliku stdout. |
| EnvironmentVariables | Opcjonalny String parametr tablicy.Tablica par zmiennych środowiskowych oddzielona znakami równości. Te zmienne są przekazywane do zduplikowanego pliku wykonywalnego oprócz zwykłego bloku środowiska lub selektywnego zastępowania. |
| ExitCode | Opcjonalny Int32 parametr tylko do odczytu.Określa kod zakończenia udostępniany przez wykonane polecenie. Jeśli zadanie zarejestrowało błędy, ale proces miał kod zakończenia 0 (powodzenie), jest to ustawione na -1. |
| HostObject | Opcjonalny ITaskHost parametr. Określa wystąpienie obiektu hosta (może mieć wartość null). Aparat kompilacji ustawia tę właściwość, jeśli środowisko IDE hosta skojarzyło obiekt hosta z tym konkretnym zadaniem. |
| Log | Opcjonalny TaskLoggingHelper parametr tylko do odczytu. Pobiera wystąpienie TaskLoggingHelperExtension klasy zawierającej metody rejestrowania zadań. |
| LogStandardErrorAsError | Parametr opcji bool .Jeśli trueprogram , wszystkie komunikaty odebrane w standardowym strumieniu błędów są rejestrowane jako błędy. |
| StandardErrorImportance | Opcjonalny String parametr.Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego. |
| StandardOutputImportance | Opcjonalny String parametr.Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego. |
| Timeout | Wirtualny parametr opcjonalny Int32 .Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu. Limit czasu wynosi w milisekundach. |
| ToolExe | Wirtualny parametr opcjonalny string .Projekty mogą implementować tę funkcję, aby zastąpić element ToolName. Zadania mogą zastąpić tę wartość, aby zachować wartość ToolName. |
| ToolPath | Opcjonalny string parametr.Określa lokalizację, z której zadanie ładuje źródłowy plik wykonywalny. Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild. |
| UseCommandProcessor | Opcjonalny bool parametr.Po ustawieniu truewartości to zadanie tworzy plik wsadowy dla wiersza polecenia i wykonuje go przy użyciu procesora poleceń zamiast bezpośredniego wykonywania polecenia. |
| YieldDuringToolExecution | Opcjonalny bool parametr.Gdy jest ustawiona wartość true, to zadanie daje węzeł, gdy jego zadanie jest wykonywane. |