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>

참고 항목