ComRegisterFunctionAttribute 類別

  • 參考

定義

命名空間:
System.Runtime.InteropServices
組件:
System.Runtime.InteropServices.dll
組件:
mscorlib.dll
組件:
netstandard.dll

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

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

範例

下列範例示範如何使用適當的簽章，將 和 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： Common Language Runtime 在) 包含元件 (直接或間接地向 Regasm.exe (元件註冊) 工具) 或透過 RegistrationServices.RegisterAssembly 方法註冊時，會使用此屬性呼叫 方法。

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

此屬性只能套用至具有下列特性的方法：

  • 範圍：任何 (公用、私人等) 。

  • 輸入：static。

  • 參數：接受單 Type 一參數或 String 參數類型。

  • 傳回類型： void 。

建構函式

ComRegisterFunctionAttribute()

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

屬性

TypeId

在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。

(繼承來源 Attribute)

方法

Equals(Object)

傳回值，這個值指出此執行個體是否與指定的物件相等。

(繼承來源 Attribute)
GetHashCode()

傳回這個執行個體的雜湊碼。

(繼承來源 Attribute)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
IsDefaultAttribute()

在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。

(繼承來源 Attribute)
Match(Object)

在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。

(繼承來源 Attribute)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。

(繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

擷取物件的類型資訊，可以用來取得介面的類型資訊。

(繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

擷取物件提供的類型資訊介面數目 (0 或 1)。

(繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

提供物件所公開的屬性和方法的存取權。

(繼承來源 Attribute)

適用於

另請參閱