ComRegisterFunctionAttribute クラス

定義

public ref class ComRegisterFunctionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class ComRegisterFunctionAttribute : 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)>]
type ComRegisterFunctionAttribute = class
    inherit 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

例

次の例では、適切なシグネチャを持つメソッドに ComRegisterFunctionAttribute と ComUnregisterFunctionAttribute を適用する方法を示します。

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 (Assembly Registration) ツール) または RegistrationServices.RegisterAssembly メソッドを使用して、含まれるアセンブリが (直接または間接的に) 登録されるときに、この属性を持つメソッドを呼び出します。

.NET Core: 共通言語ランタイムは、RegSvr32.exe ツールを使用して、含まれるアセンブリの COM ホストが登録されている場合に、この属性を持つメソッドを呼び出します。

この属性は、次の特性を持つメソッドにのみ適用できます。

• スコープ: 任意 (パブリック、プライベートなど)。

• タイプ: static

• パラメーター: 単一の Type パラメーターまたは String パラメーター型を受け入れます。

• 戻り値の型: void。

こちらもご覧ください

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (アセンブリ登録ツール)