업데이트: 2007년 11월
Task 요소에서 참조하는 작업을 작업의 구현이 포함된 어셈블리에 매핑합니다.
<UsingTask TaskName="TaskName"
AssemblyName = "AssemblyName"
Condition="'String A'=='String B'" />
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
|---|---|
AssemblyName |
AssemblyName 또는 AssemblyFile 특성이 필요합니다. 로드할 어셈블리의 이름입니다. AssemblyName 특성에서는 강력한 이름의 어셈블리를 허용하지만 필수적 요소는 아닙니다. 이 특성을 사용하면 .NET Framework에서 LoadFrom 메서드를 통해 어셈블리를 로드하는 것과 같은 결과를 얻을 수 있습니다. AssemblyFile 특성을 사용하는 경우에는 이 특성을 사용할 수 없습니다. |
AssemblyFile |
AssemblyName 또는 AssemblyFile 특성이 필요합니다. 어셈블리의 파일 경로입니다. 이 특성에는 전체 경로와 상대 경로를 모두 사용할 수 있습니다. 상대 경로는 UsingTask 요소가 선언된 대상 파일이나 프로젝트의 디렉터리를 기준으로 합니다. 이 특성을 사용하면 .NET Framework에서 LoadFrom 메서드를 통해 어셈블리를 로드하는 것과 같은 결과를 얻을 수 있습니다. AssemblyName 특성을 사용하는 경우에는 이 특성을 사용할 수 없습니다. |
TaskName |
필수 특성입니다. 어셈블리에서 참조할 작업의 이름입니다. 모호성이 발생할 가능성이 있으면 이 특성에 항상 전체 네임스페이스를 지정해야 합니다. 모호성이 있으면 MSBuild에서는 일치하는 임의의 항목을 선택하므로 예기치 않은 결과가 발생할 수 있습니다. |
Condition |
선택적 특성입니다. 확인할 조건입니다. 자세한 내용은 MSBuild 조건을 참조하십시오. |
자식 요소
없음
부모 요소
요소 |
설명 |
|---|---|
MSBuild 프로젝트 파일의 필수 루트 요소입니다. |
설명
환경 변수, 명령줄 속성 및 프로젝트 수준 속성은 UsingTask 요소가 명시적으로 또는 가져온 프로젝트 파일을 통해 프로젝트 파일 안에 표시되는 한 이 요소 내에서 위치에 상관없이 참조할 수 있습니다. 자세한 내용은 MSBuild 작업을 참조하십시오.
참고
MSBuild 엔진을 통해 전역으로 등록된 .tasks 파일 중 하나에서 UsingTask 요소를 가져오는 경우 프로젝트 수준 속성에는 의미가 없습니다. 이러한 속성은 MSBuild에 대해 전역이 아닙니다.
예제
다음 예제에서는 UsingTask 요소를 AssemblyName 특성과 함께 사용하는 방법을 보여 줍니다.
<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
AssemblyName="Microsoft.Build.Tasks" />
다음 예제에서는 UsingTask 요소를 AssemblyFile 특성과 함께 사용하는 방법을 보여 줍니다.
<UsingTask TaskName="Email"
AssemblyFile="c:\myTasks\myTask.dll" />