RegisterAssembly 작업
지정된 어셈블리 내의 메타데이터를 읽고 필요한 엔트리를 레지스트리에 추가할 수 있습니다. 이렇게 하면 COM 클라이언트에서 .NET Framework 클래스를 투명하게 만들 수 있습니다. 이 작업의 동작은 Regasm.exe(어셈블리 등록 도구)의 동작과 비슷하지만 같지는 않습니다.
매개 변수
다음 표에서는 RegisterAssembly
작업의 매개 변수에 대해 설명합니다.
매개 변수 | Description |
---|---|
Assemblies |
필수 ITaskItem[] 매개 변수입니다.COM에 등록할 어셈블리를 지정합니다. |
AssemblyListFile |
선택적 ITaskItem 매개 변수입니다.RegisterAssembly 작업과 UnregisterAssembly 작업 사이의 상태에 대한 정보를 포함합니다. 이 정보를 통해 UnregisterAssembly 작업이 RegisterAssembly 작업에서 등록되지 못한 어셈블리의 등록을 취소하려고 하는 시도를 방지합니다. |
CreateCodeBase |
선택적 Boolean 매개 변수입니다.true 이면 전역 어셈블리 캐시에 설치되지 않은 어셈블리에 대한 파일 경로를 지정하는 코드베이스 항목을 레지스트리에 만듭니다. 전역 어셈블리 캐시에 등록 중인 어셈블리를 다음에 설치하려면 이 옵션을 지정해야 합니다. |
TypeLibFiles |
선택적 ITaskItem[] 출력 매개 변수입니다.지정된 어셈블리에서 생성할 형식 라이브러리를 지정합니다. 생성된 형식 라이브러리에는 어셈블리 내에 정의된 액세스 가능 형식에 대한 정의가 들어 있습니다. 형식 라이브러리는 다음 조건 중 하나가 충족되는 경우에만 생성됩니다. - 해당 이름의 형식 라이브러리가 해당 위치에 존재하지 않습니다. - 형식 라이브러리는 존재하지만 전달되는 어셈블리보다 오래된 것입니다. 형식 라이브러리가 전달되는 어셈블리보다 최신인 경우 새 형식 라이브러리가 만들어지지 않으며 어셈블리는 계속 등록됩니다. 이 매개 변수를 지정하는 경우 Assemblies 매개 변수와 동일한 수의 항목이 포함되어야 하며, 그러지 않으면 작업이 실패합니다. 입력을 지정하지 않으면 작업은 기본적으로 어셈블리의 이름이 되며 항목의 확장명을 .tlb로 변경합니다. |
설명
이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension 기본 클래스를 참조하세요.
예시
다음 예제에서는 RegisterAssembly
작업을 사용하여 MyAssemblies
항목 컬렉션으로 지정된 어셈블리를 등록합니다.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MyAssemblies Include="MyAssembly.dll" />
<ItemGroup>
<Target Name="RegisterAssemblies">
<RegisterAssembly
Assemblies="@(MyAssemblies)" >
</Target>
</Project>