ComUnregisterFunctionAttribute クラス

.NET Framework クラス ライブラリ リファレンス

ComUnregisterFunctionAttribute クラス

COM で使用できるように登録したアセンブリの登録を解除するときに呼び出すメソッドを指定します。これにより、登録解除中にユーザー記述コードを実行できます。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Method, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 ComUnregisterFunctionAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As ComUnregisterFunctionAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)]
 
[ComVisibleAttribute(true)] 
public sealed class ComUnregisterFunctionAttribute
 : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Method, Inherited=false)]
 
[ComVisibleAttribute(true)] 
public ref class ComUnregisterFunctionAttribute
 sealed : public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)
 */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class ComUnregisterFunctionAttribute
 extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)
 
ComVisibleAttribute(true) 
public final class ComUnregisterFunctionAttribute
 extends Attribute

解説

この属性は、メソッドに適用できます。

ComUnregisterFunctionAttribute を使用すると、登録メソッドが実行した操作を元に戻すためのコードを追加できます。ComRegisterFunctionAttribute を適用して登録メソッドを提供する場合は、その登録メソッドで実行された操作を元に戻すための登録解除メソッドも提供する必要があります。登録解除メソッドは 1 クラスにつき 1 つしか提供できません。

格納しているアセンブリが アセンブリ登録ツール (Regasm.exe) や RegistrationServices.UnregisterAssembly API メソッドを使用して (直接または間接的に) 登録解除される場合、共通言語ランタイムはこの属性を持つメソッドを呼び出します。この属性を持つメソッドの参照可能範囲 (パブリック、プライベートなど) は任意ですが、このメソッドは static である必要があり、登録解除する Type を表す Type パラメータを 1 つ受け取る必要があります。

使用例

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

Visual Basic

Imports System
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

C#

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.
   }
}

C++

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.
   }

};

J#

import System.*;
import System.Runtime.InteropServices.*;

public class MyClassThatNeedsToRegister
{
    /** @attribute ComRegisterFunctionAttribute()
     */
    public static void RegisterFunction(Type
 t)
    {
        //Insert code here.
    } //RegisterFunction

    /** @attribute ComUnregisterFunctionAttribute()
     */
    public static void UnregisterFunction(Type
 t)
    {
        //Insert code here.
    } //UnregisterFunction
} //MyClassThatNeedsToRegister

JScript

import System;
import System.Runtime.InteropServices;

public class MyClassThatNeedsToRegister
{
   ComRegisterFunctionAttribute public static
 function RegisterFunction(t : Type) : void
 
   {
      //Insert code here.
   }
   
   ComUnregisterFunctionAttribute public static
 function UnregisterFunction(t : Type) : void
   {
      //Insert code here.
   }
}

継承階層

System.Object
   System.Attribute
    System.Runtime.InteropServices.ComUnregisterFunctionAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ComUnregisterFunctionAttribute メンバ
System.Runtime.InteropServices 名前空間
ComRegisterFunctionAttribute クラス
RegistrationServices.UnregisterAssembly
その他の技術情報
アセンブリ登録ツール (Regasm.exe)