Task 요소(MSBuild)
MSBuild 작업의 인스턴스를 만들고 실행합니다. 요소 이름은 작성하려는 작업의 이름에 따라 결정됩니다.
<Task Parameter1="Value1"... ParameterN="ValueN"
ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
Condition="'String A' == 'String B'" >
<Output... />
</Task>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
---|---|
Condition |
선택적 특성입니다. 확인할 조건입니다. 자세한 내용은 MSBuild 조건을 참조하십시오. |
ContinueOnError |
선택적 특성입니다. 다음 값 중 하나가 포함 될 수 있습니다.
버전 4.5 에서만 지원 하기 전에.NET Framework true 및 false 값입니다. 자세한 내용은 방법: 작업의 오류 무시을 참조하십시오. |
Parameter |
[Required] 특성으로 레이블이 설정된 속성이 작업 클래스에 하나 이상 들어 있는 경우 필수적 요소입니다. 매개 변수 값을 해당 값으로 포함하는 사용자 정의 작업 매개 변수입니다. Task 요소에 포함되는 매개 변수의 수에는 제한이 없으며 각 특성은 작업 클래스의 .NET 속성에 매핑됩니다. |
자식 요소
요소 |
설명 |
---|---|
작업의 출력을 프로젝트 파일에 저장합니다. 작업에 Output 요소가 0개 이상 있을 수 있습니다. |
부모 요소
요소 |
설명 |
---|---|
MSBuild 작업에 대한 컨테이너 요소입니다. |
설명
MSBuild 프로젝트 파일의 Task 요소는 작업의 인스턴스를 만들고, 속성을 설정하고, 이를 실행합니다. Output 요소는 프로젝트 파일의 다른 곳에 사용할 속성이나 항목에 출력 매개 변수를 저장합니다.
작업의 부모 Target 요소에 OnError 요소가 있으면 작업이 실패하고 ContinueOnError의 값이 false이더라도 이러한 요소를 확인합니다. 작업에 대한 자세한 내용은 MSBuild 작업을 참조하십시오.
예제
다음 코드 예제에서는 Csc task 클래스의 인스턴스를 만들고 여섯 가지 속성을 설정하고 작업을 실행합니다. 작업을 실행한 후에 개체의 OutputAssembly 속성 값이 FinalAssemblyName이라는 항목 목록에 배치됩니다.
<Target Name="Compile" DependsOnTarget="Resources" >
<Csc Sources="@(CSFile)"
TargetType="library"
Resources="@(CompiledResources)"
EmitDebugInformation="$(includeDebugInformation)"
References="@(Reference)"
DebugType="$(debuggingType)" >
<Output TaskParameter="OutputAssembly"
ItemName="FinalAssemblyName" />
</Csc>
</Target>