RegisterAssembly 작업RegisterAssembly Task

지정된 어셈블리 내의 메타데이터를 읽고 필요한 엔트리를 레지스트리에 추가할 수 있습니다. 이렇게 하면 COM 클라이언트에서 .NET Framework.NET Framework 클래스를 투명하게 만들 수 있습니다.Reads the metadata within the specified assembly and adds the necessary entries to the registry, which allows COM clients to create .NET Framework.NET Framework classes transparently. 이 작업의 동작은 Regasm.exe(어셈블리 등록 도구)의 동작과 비슷하지만 같지는 않습니다.The behavior of this task is similar, but not identical, to that of the Regasm.exe (Assembly Registration Tool).

매개 변수Parameters

다음 표에서는 RegisterAssembly 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the RegisterAssembly task.

매개 변수Parameter 설명Description
Assemblies 필수 ITaskItem[] 매개 변수입니다.Required ITaskItem[] parameter.

COM에 등록할 어셈블리를 지정합니다.Specifies the assemblies to be registered with COM.
AssemblyListFile 선택적 ITaskItem 매개 변수입니다.Optional ITaskItem parameter.

RegisterAssembly 작업과 UnregisterAssembly 작업 사이의 상태에 대한 정보를 포함합니다.Contains information about the state between the RegisterAssembly task and the UnregisterAssembly task. 이를 통해 UnregisterAssembly 작업이 RegisterAssembly 작업에서 등록하지 못한 어셈블리의 등록을 취소하려고 하는 시도를 방지합니다.This prevents the UnregisterAssembly task from attempting to unregister an assembly that failed to register in the RegisterAssembly task.
CreateCodeBase 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true이면 전역 어셈블리 캐시에 설치되지 않은 어셈블리에 대한 파일 경로를 지정하는 코드베이스 항목을 레지스트리에 만듭니다.If true, creates a codebase entry in the registry, which specifies the file path for an assembly that is not installed in the global assembly cache. 전역 어셈블리 캐시에 등록 중인 어셈블리를 다음에 설치하려면 이 옵션을 지정해야 합니다.You should not specify this option if you will subsequently install the assembly that you are registering into the global assembly cache.
TypeLibFiles 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

지정된 어셈블리에서 생성할 형식 라이브러리를 지정합니다.Specifies the type library to generate from the specified assembly. 생성된 형식 라이브러리에는 어셈블리 내에 정의된 액세스 가능 형식에 대한 정의가 들어 있습니다.The generated type library contains definitions of the accessible types defined within the assembly. 형식 라이브러리는 다음 조건 중 하나가 충족되는 경우에만 생성됩니다.The type library is only generated if one of the following is true:

- 해당 이름의 형식 라이브러리가 해당 위치에 존재하지 않습니다.- A type library of that name does not exist at that location.
- 형식 라이브러리는 존재하지만 전달되는 어셈블리보다 오래된 것입니다.- A type library exists but it is older than the assembly being passed in.

형식 라이브러리가 전달되는 어셈블리보다 최신인 경우 새 형식 라이브러리가 만들어지지 않으며 어셈블리는 계속 등록됩니다.If the type library is newer than the assembly being passed, a new one will not be created, but the assembly will still be registered.

이 매개 변수를 지정하는 경우 Assemblies 매개 변수와 동일한 수의 항목이 포함되어야 하며, 그러지 않으면 작업이 실패합니다.If this parameter is specified, it must have the same number of items as the Assemblies parameter or the task will fail. 입력을 지정하지 않으면 작업은 기본적으로 어셈블리의 이름이 되며 항목의 확장명을 .tlb로 변경합니다.If no inputs are specified, the task will default to the name of the assembly and change the extension of the item to .tlb.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension Base Class를 참조하세요.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

Example

다음 예제에서는 RegisterAssembly 작업을 사용하여 MyAssemblies 항목 컬렉션으로 지정된 어셈블리를 등록합니다.The following example uses the RegisterAssembly task to register the assembly specified by the MyAssemblies item collection.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  

    <ItemGroup>  
        <MyAssemblies Include="MyAssembly.dll" />  
    <ItemGroup>  

    <Target Name="RegisterAssemblies">  
        <RegisterAssembly  
            Assemblies="@(MyAssemblies)" >  
    </Target>  

</Project>  

참고 항목See Also

작업 Tasks
작업 참조Task Reference