다음을 통해 공유


ToolTaskExtension 기본 클래스

많은 작업은 Task 클래스에서 상속되는 ToolTask 클래스에서 상속되는 ToolTaskExtension 클래스에서 상속됩니다. 이 상속 체인은 매개 변수에서 파생되는 작업에 해당 매개 변수 몇 개를 추가합니다. 이러한 매개 변수는 이 문서에 나열되어 있습니다.

매개 변수

다음 표에서는 기본 클래스의 매개 변수에 대해 설명합니다.

Parameter

설명

BuildEngine

선택적 IBuildEngine 매개 변수입니다.

작업에 사용할 수 있는 빌드 엔진 인터페이스를 지정합니다. 빌드 엔진에서는 작업에서 빌드 엔진으로 다시 호출할 수 있도록 이 매개 변수를 자동으로 설정합니다.

BuildEngine2

선택적 IBuildEngine2 매개 변수입니다.

작업에 사용할 수 있는 빌드 엔진 인터페이스를 지정합니다. 빌드 엔진에서는 작업에서 빌드 엔진으로 다시 호출할 수 있도록 이 매개 변수를 자동으로 설정합니다.

이는 이 클래스에서 상속하는 작업 작성자가 값을 IBuildEngine에서 IBuildEngine2로 캐스트하지 않아도 되도록 해 주는 편의 속성입니다.

BuildEngine3

선택적 IBuildEngine3 매개 변수입니다.

호스트에서 제공하는 빌드 엔진 인터페이스를 지정합니다.

EchoOff

선택적 bool 매개 변수입니다.

true로 설정된 경우 이 작업은 명령줄이 stdout으로 복사되지 않도록 /Q를 cmd.exe 명령줄로 전달합니다.

EnvironmentVariables

선택적 String 배열 매개 변수입니다.

등호로 구분된 환경 변수 쌍의 배열입니다. 이 변수는 생성된 실행 파일에 전달되면서 일반 환경 블록에 추가되거나 일부 일반 환경 블록을 재정의합니다.

ExitCode

선택적 Int32 읽기 전용 출력 매개 변수입니다.

실행한 명령에서 제공하는 종료 코드를 지정합니다. 작업에서 오류를 기록했지만 프로세스가 종료 코드 0(성공_을 반환한 경우 이는 -1로 설정됩니다.

HostObject

선택적 ITaskHost 매개 변수입니다.

호스트 개체 인스턴스를 지정합니다(null일 수 있음). 호스트 IDE에서 호스트 개체를 이 특정 작업과 연결한 경우 빌드 엔진에서 이 속성을 설정합니다.

Log

선택적 TaskLoggingHelper 읽기 전용 매개 변수입니다.

작업 로깅 메서드가 들어 있는 TaskLoggingHelperExtension 클래스의 인스턴스를 가져옵니다.

LogStandardErrorAsError

선택적 bool 매개 변수입니다.

true인 경우 표준 오류 스트림에서 받은 모든 메시지가 오류로 기록됩니다.

StandardErrorImportance

선택적 String 매개 변수입니다.

표준 출력 스트림의 텍스트를 기록할 때 적용할 중요도입니다.

StandardOutputImportance

선택적 String 매개 변수입니다.

표준 출력 스트림의 텍스트를 기록할 때 적용할 중요도입니다.

Timeout

가상의 선택적 Int32 매개 변수입니다.

작업 실행 파일이 얼마 후에 종료될 지를 밀리초 단위로 지정합니다. 기본값은 시간 제한이 없음을 나타내는 Int.MaxValue입니다. 시간 제한의 단위는 밀리초입니다.

ToolExe

가상의 선택적 string 매개 변수입니다.

프로젝트에서 작업의 ToolName을 재정의하기 위해 이를 구현할 수 있습니다. 작업에서는 ToolName을 유지하기 위해 이를 재정의할 수 있습니다.

ToolPath

선택적 string 매개 변수입니다.

작업에서 내부 실행 파일을 로드할 위치를 지정합니다. 이 매개 변수를 지정하지 않으면 작업에서는 MSBuild를 실행하고 있는 버전의 Framework에 해당하는 SDK 설치 경로가 사용됩니다.

UseCommandProcessor

선택적 bool 매개 변수입니다.

true로 설정된 경우 이 작업은 명령줄에 대한 배치 파일을 만들고 명령을 직접 실행하는 대신 명령 처리기를 사용하여 실행합니다.

YieldDuringToolExecution

선택적 bool 매개 변수입니다.

true로 설정된 경우 작업이 실행 중이면 이 작업이 노드를 발생시킵니다.

참고 항목

개념

MSBuild 작업

기타 리소스

MSBuild 작업 참조