ToolTaskExtension 기본 클래스ToolTaskExtension Base Class

많은 작업은 Task 클래스에서 상속되는 ToolTask 클래스에서 상속되는 ToolTaskExtension 클래스에서 상속됩니다.Many tasks inherit from the ToolTaskExtension class, which inherits from the ToolTask class, which itself inherits from the Task class. 이 상속 체인은 매개 변수에서 파생되는 작업에 해당 매개 변수 몇 개를 추가합니다.This inheritance chain adds several parameters to the tasks that derive from them. 이러한 매개 변수가 이 문서에 나열되어 있습니다.These parameters are listed in this document.

매개 변수Parameters

다음 표에서는 기본 클래스의 매개 변수에 대해 설명합니다.The following table describes the parameters of the base classes.

매개 변수Parameter 설명Description
BuildEngine 선택적 IBuildEngine 매개 변수입니다.Optional IBuildEngine parameter.

작업에 사용할 수 있는 빌드 엔진 인터페이스를 지정합니다.Specifies the build engine interface available to tasks. 빌드 엔진에서는 작업에서 빌드 엔진으로 다시 호출할 수 있도록 이 매개 변수를 자동으로 설정합니다.The build engine automatically sets this parameter to allow tasks to call back into it.
BuildEngine2 선택적 IBuildEngine2 매개 변수입니다.Optional IBuildEngine2 parameter.

작업에 사용할 수 있는 빌드 엔진 인터페이스를 지정합니다.Specifies the build engine interface available to tasks. 빌드 엔진에서는 작업에서 빌드 엔진으로 다시 호출할 수 있도록 이 매개 변수를 자동으로 설정합니다.The build engine automatically sets this parameter to allow tasks to call back into it.

이는 이 클래스에서 상속하는 작업 작성자가 값을 IBuildEngine에서 IBuildEngine2로 캐스트하지 않아도 되도록 해 주는 편의 속성입니다.This is a convenience property so that task authors inheriting from this class do not have to cast the value from IBuildEngine to IBuildEngine2.
BuildEngine3 선택적 IBuildEngine3 매개 변수입니다.Optional IBuildEngine3 parameter.

호스트에서 제공하는 빌드 엔진 인터페이스를 지정합니다.Specifies the build engine interface provided by the host.
EchoOff 선택적 bool 매개 변수입니다.Optional bool parameter.

true로 설정된 경우 이 작업은 명령줄이 stdout으로 복사되지 않도록 /Q를 cmd.exe 명령줄로 전달합니다.When set to true, this task passes /Q to the cmd.exe command line such that the command line does not get copied to stdout.
EnvironmentVariables 선택적 String 배열 매개 변수입니다.Optional String array parameter.

등호로 구분된 환경 변수 쌍의 배열입니다.Array of pairs of environment variables, separated by equal signs. 이 변수는 생성된 실행 파일에 전달되면서 일반 환경 블록에 추가되거나 일부 일반 환경 블록을 재정의합니다.These variables are passed to the spawned executable in addition to, or selectively overriding, the regular environment block.
ExitCode 선택적 Int32 읽기 전용 출력 매개 변수입니다.Optional Int32 output read-only parameter.

실행한 명령에서 제공하는 종료 코드를 지정합니다.Specifies the exit code that is provided by the executed command. 작업에서 오류를 기록했지만 프로세스가 종료 코드 0(성공)을 반환한 경우 이는 -1로 설정됩니다.If the task logged any errors, but the process had an exit code of 0 (success), this is set to -1.
HostObject 선택적 ITaskHost 매개 변수입니다.Optional ITaskHost parameter.

호스트 개체 인스턴스를 지정합니다(null일 수 있음).Specifies the host object instance (can be null). 호스트 IDE에서 호스트 개체를 이 특정 작업과 연결한 경우 빌드 엔진에서 이 속성을 설정합니다.The build engine sets this property if the host IDE has associated a host object with this particular task.
Log 선택적 TaskLoggingHelper 읽기 전용 매개 변수입니다.Optional TaskLoggingHelper read-only parameter.

작업 로깅 메서드가 들어 있는 TaskLoggingHelperExtension 클래스의 인스턴스를 가져옵니다.Gets an instance of a TaskLoggingHelperExtension class that contains task logging methods.
LogStandardErrorAsError 선택적 bool 매개 변수입니다.Option bool parameter.

true인 경우 표준 오류 스트림에서 받은 모든 메시지가 오류로 기록됩니다.If true, all messages received on the standard error stream are logged as errors.
StandardErrorImportance 선택적 String 매개 변수입니다.Optional String parameter.

표준 출력 스트림의 텍스트를 기록할 때 적용할 중요도입니다.Importance with which to log text from the standard out stream.
StandardOutputImportance 선택적 String 매개 변수입니다.Optional String parameter.

표준 출력 스트림의 텍스트를 기록할 때 적용할 중요도입니다.Importance with which to log text from the standard out stream.
Timeout 가상의 선택적 Int32 매개 변수입니다.Virtual optional Int32 parameter.

작업 실행 파일이 얼마 후에 종료될 지를 밀리초 단위로 지정합니다.Specifies the amount of time, in milliseconds, after which the task executable is terminated. 기본값은 시간 제한이 없음을 나타내는 Int.MaxValue입니다. 시간 제한의 단위는 밀리초입니다.The default value is Int.MaxValue, indicating that there is no time out period.Time-out is in milliseconds.
ToolExe 가상의 선택적 string 매개 변수입니다.Virtual optional string parameter.

프로젝트에서 작업의 ToolName을 재정의하기 위해 이를 구현할 수 있습니다.Projects may implement this to override a ToolName. 작업에서는 ToolName을 유지하기 위해 이를 재정의할 수 있습니다.Tasks may override this to preserve the ToolName.
ToolPath 선택적 string 매개 변수입니다.Optional string parameter.

작업에서 내부 실행 파일을 로드할 위치를 지정합니다.Specifies the location from where the task loads the underlying executable file. 이 매개 변수를 지정하지 않으면 작업에서는 MSBuildMSBuild를 실행하고 있는 버전의 Framework에 해당하는 SDK 설치 경로가 사용됩니다.If this parameter is not specified, the task uses the SDK installation path that corresponds to the version of the framework that is running MSBuildMSBuild.
UseCommandProcessor 선택적 bool 매개 변수입니다.Optional bool parameter.

true로 설정된 경우 이 작업은 명령줄에 대한 배치 파일을 만들고 명령을 직접 실행하는 대신 명령 처리기를 사용하여 실행합니다.When set to true, this task creates a batch file for the command line and executes it by using the command-processor instead of executing the command directly.
YieldDuringToolExecution 선택적 bool 매개 변수입니다.Optional bool parameter.

true로 설정된 경우 작업이 실행 중이면 이 작업이 노드를 발생시킵니다.When set to true, this task yields the node when its task is executing.

참고 항목See Also

작업 참조 Task Reference
작업Tasks