MSBuild 작업의 인스턴스를 만들고 실행합니다. 요소 이름은 작성하려는 작업의 이름에 따라 결정됩니다.
<Task Parameter1="Value1"... ParameterN="ValueN"
ContinueOnError="true/false"
Condition="'String A' == 'String B'" >
<Output... />
</Task>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
|---|---|
Condition |
선택적 특성입니다. 확인할 조건입니다. 자세한 내용은 MSBuild 조건을 참조하십시오. |
ContinueOnError |
선택적 특성입니다. 지정하지 않은 경우 false로 기본 설정되는 부울 특성입니다. ContinueOnError가 false이고 작업이 실패하면 Target 요소의 나머지 작업이 실행되지 않고 전체 Target 요소가 실패한 것으로 간주됩니다. 이 특성이 true이면 현재 작업이 실패하더라도 Target 요소의 나머지 작업이 계속하여 실행되고 작업의 모든 오류가 경고로 처리됩니다. |
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>