Udostępnij za pośrednictwem

ToolTaskExtension, klasa podstawowa

  • Artykuł

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.

Zobacz też