ComUnregisterFunctionAttribute 類別

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

指定當您移除登錄來自 COM 的所用組件 (Assembly) 時要呼叫的方法；這允許移除登錄程序期間的使用者撰寫程式碼的執行。

public ref class ComUnregisterFunctionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class ComUnregisterFunctionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type ComUnregisterFunctionAttribute = class
    inherit Attribute

Public NotInheritable Class ComUnregisterFunctionAttribute
Inherits Attribute

繼承

Object

Attribute

ComUnregisterFunctionAttribute

屬性

AttributeUsageAttribute

範例

下列範例示範如何使用 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

備註

您可以將此屬性套用至方法。

ComUnregisterFunctionAttribute 可讓您新增程序代碼，以反轉註冊方法所執行的作業。 如果您套用 ComRegisterFunctionAttribute 來提供註冊方法，您也應該提供取消系結方法，以反轉註冊方法中完成的作業。 您只能有一個類別的取消系結方法。

.NET Framework： Common Language Runtime 會在包含元件直接或間接 (與 Regasm.exe (元件 註冊) 工具) 或透過 RegistrationServices.RegisterAssembly 方法) 時，使用這個屬性呼叫 方法。

.NET Core： Common Language Runtime 會在透過 RegSvr32.exe 工具取消註冊包含元件的 COM 主機時，使用這個屬性呼叫 方法。

建構函式

ComUnregisterFunctionAttribute()

初始化 ComUnregisterFunctionAttribute 類別的新執行個體。

屬性

TypeId

在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• ComRegisterFunctionAttribute
• UnregisterAssembly(Assembly)
• Regasm.exe (組件登錄工具)