Task 요소(MSBuild)Task Element (MSBuild)

MSBuildMSBuild 작업의 인스턴스를 만들고 실행합니다.Creates and executes an instance of an MSBuildMSBuild task. 생성된 작업 이름에 따라 요소 이름이 결정됩니다.The element name is determined by the name of the task being created.

<Project><Project>
<Target><Target>

구문Syntax

<Task Parameter1="Value1"... ParameterN="ValueN"  
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"  
    Condition="'String A' == 'String B'" >  
    <Output... />  
</Task>  

특성 및 요소Attributes and Elements

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.The following sections describe attributes, child elements, and parent elements.

특성Attributes

특성Attribute 설명Description
Condition 선택적 특성입니다.Optional attribute. 평가할 조건입니다.Condition to be evaluated. 자세한 내용은 조건을 참조하세요.For more information, see Conditions.
ContinueOnError 선택적 특성입니다.Optional attribute. 다음 값 중 하나를 포함할 수 있습니다.Can contain one of the following values:

- WarnAndContinue 또는 true.- WarnAndContinue or true. 작업이 실패할 경우 Target 요소의 후속 작업과 빌드가 계속 실행되고 작업에서 발생한 모든 오류가 경고로 처리됩니다.When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as warnings.
- ErrorAndContinue.- ErrorAndContinue. 작업이 실패할 경우 Target 요소의 후속 작업과 빌드가 계속 실행되고 작업에서 발생한 모든 오류가 오류로 처리됩니다.When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as errors.
- ErrorAndStop 또는 false(기본값).- ErrorAndStop or false (default). 작업이 실패할 경우 Target 요소의 나머지 작업이 실행되지 않고 전체 Target 요소와 빌드가 실패한 것으로 간주됩니다.When a task fails, the remaining tasks in the Target element and the build aren't executed, and the entire Target element and the build is considered to have failed.

.NET Framework 4.5 이전 버전은 truefalse 값만 지원합니다.Versions of the .NET Framework before 4.5 supported only the true and false values.

자세한 내용은 방법: 작업의 오류 무시를 참조하세요.For more information, see How to: Ignore Errors in Tasks.
Parameter 작업 클래스에 [Required] 특성으로 레이블이 지정된 하나 이상의 속성이 포함된 경우 필수입니다.Required if the task class contains one or more properties labeled with the [Required] attribute.

값으로 매개 변수 값을 포함하는 사용자 정의 작업 매개 변수입니다.A user-defined task parameter that contains the parameter value as its value. Task 요소에는 여러 매개 변수가 있을 수 있으며 각 특성은 작업 클래스의 .NET 속성에 매핑됩니다.There can be any number of parameters in the Task element, with each attribute mapping to a .NET property in the task class.

자식 요소Child Elements

요소Element 설명Description
OutputOutput 프로젝트 파일의 작업에서 출력을 저장합니다.Stores outputs from the task in the project file. 작업에는 Output 요소가 없을 수도 있고 하나 이상 있을 수도 있습니다.There may be zero or more Output elements in a task.

부모 요소Parent Elements

요소Element 설명Description
TargetTarget MSBuildMSBuild 작업의 컨테이너 요소입니다.Container element for MSBuildMSBuild tasks.

주의Remarks

MSBuildMSBuild 프로젝트 파일의 Task 요소는 작업의 인스턴스를 생성하며 작업에 대한 속성을 설정하고 작업을 실행합니다.A Task element in an MSBuildMSBuild project file creates an instance of a task, sets properties on it, and executes it. Output 요소는 프로젝트 파일의 다른 곳에서 사용될 속성이나 항목에 출력 매개 변수를 저장합니다.The Output element stores output parameters in properties or items to be used elsewhere in the project file.

작업의 상위 Target 요소에 OnError 요소가 있는 경우 작업이 실패하고 ContinueOnErrorfalse 값이 있으면 계속 평가됩니다.If there are any OnError elements in the parent Target element of a task, they will still be evaluated if the task fails and ContinueOnError has a value of false. 작업에 대한 자세한 내용은 작업을 참조하세요.For more information on tasks, see Tasks.

예제Example

다음 코드 예제에서는 Csc task 클래스의 인스턴스를 만들고 6개의 속성을 설정하며 작업을 실행합니다.The following code example creates an instance of the Csc task class, sets six of the properties, and executes the task. 실행한 후에는 개체의 OutputAssembly 속성 값이 FinalAssemblyName이라는 항목 목록에 배치됩니다.After execution, the value of the OutputAssembly property of the object is placed into an item list named 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>  

참고 항목See Also

작업 Tasks
작업 참조 Task Reference
프로젝트 파일 스키마 참조Project File Schema Reference