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