ComRegisterFunctionAttribute 클래스

정의

네임스페이스:

System.Runtime.InteropServices

어셈블리:

mscorlib.dll

COM에서 사용할 어셈블리를 등록할 때 호출할 메서드를 지정합니다. 이렇게 하면 등록 프로세스 중에 사용자가 작성한 코드를 실행할 수 있습니다.

public ref class ComRegisterFunctionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComRegisterFunctionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComRegisterFunctionAttribute = class
    inherit Attribute

Public NotInheritable Class ComRegisterFunctionAttribute
Inherits Attribute

상속

Object

Attribute

ComRegisterFunctionAttribute

특성

AttributeUsageAttribute ComVisibleAttribute

예제

다음 예제에서는 적절한 서명을 사용하여 메서드를 적용하고 ComUnregisterFunctionAttribute 메서드에 적용 ComRegisterFunctionAttribute 하는 방법을 보여 줍니다.

using namespace System;
using namespace System::Runtime::InteropServices;
public ref class MyClassThatNeedsToRegister
{
public:

   [ComRegisterFunctionAttribute]
   static void RegisterFunction( Type^ t )
   {
      
      //Insert code here.
   }


   [ComUnregisterFunctionAttribute]
   static void UnregisterFunction( Type^ t )
   {
      
      //Insert code here.
   }

};

using System;
using System.Runtime.InteropServices;

public class MyClassThatNeedsToRegister
{
   [ComRegisterFunctionAttribute]
   public static void RegisterFunction(Type t)
   {
      //Insert code here.
   }

   [ComUnregisterFunctionAttribute]
   public static void UnregisterFunction(Type t)
   {
      //Insert code here.
   }
}

Imports System.Runtime.InteropServices

Public Class MyClassThatNeedsToRegister
    
    <ComRegisterFunctionAttribute()> Public Shared Sub _
      RegisterFunction(t As Type)
        'Insert code here.
    End Sub
    
    <ComUnregisterFunctionAttribute()> Public Shared Sub _
      UnregisterFunction(t As Type)
        'Insert code here.
    End Sub
End Class

설명

메서드에 이 특성을 적용할 수 있습니다.

ComRegisterFunctionAttribute 를 사용하면 COM 클라이언트의 요구 사항을 수용하기 위해 임의의 등록 코드를 추가할 수 있습니다. 예를 들어 Microsoft.Win32 네임스페이스의 등록 함수를 사용하여 레지스트리를 업데이트할 수 있습니다. 등록 방법을 제공하는 경우 등록 메서드에서 수행된 작업을 반대로 하는 등록 취소 메서드에도 적용 System.Runtime.InteropServices.ComUnregisterFunctionAttribute 해야 합니다.

.NET Framework: 공용 언어 런타임은 포함된 어셈블리가 Regasm.exe(어셈블리 등록) 도구) 또는 RegistrationServices.RegisterAssembly 메서드를 통해 직접 또는 간접적으로 등록될 때 이 특성으로 메서드를 호출합니다.

.NET Core: 공용 언어 런타임은 포함된 어셈블리의 COM 호스트가 RegSvr32.exe 도구 통해 등록될 때 이 특성으로 메서드를 호출합니다.

이 특성은 다음과 같은 특성을 가진 메서드에만 적용할 수 있습니다.

• 범위: 모든 항목(퍼블릭, 프라이빗 등).

• 형식: static.

• 매개 변수: 단일 Type 매개 변수 또는 매개 변수 형식을 String 허용합니다.

• 반환 형식: void.

생성자

Name	Description
ComRegisterFunctionAttribute()	ComRegisterFunctionAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
TypeId	파생 클래스에서 구현되는 경우 이 Attribute대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)

메서드

Name	Description
Equals(Object)	이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의되는 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의되는 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	이름 집합을 해당 디스패치 식별자 집합에 매핑합니다. (다음에서 상속됨 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다. (다음에서 상속됨 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	개체가 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1). (다음에서 상속됨 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	개체에 의해 노출되는 속성 및 메서드에 대한 액세스를 제공합니다. (다음에서 상속됨 Attribute)

추가 정보

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe(어셈블리 등록 도구)