ComRegisterFunctionAttribute Třída

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

mscorlib.dll

Určuje metodu, která se má volat při registraci sestavení pro použití z modelu COM; to umožňuje provádění uživatelem psaného kódu během procesu registrace.

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

Dědičnost

Object

Attribute

ComRegisterFunctionAttribute

Atributy

AttributeUsageAttribute ComVisibleAttribute

Příklady

Následující příklad ukazuje, jak použít ComRegisterFunctionAttribute a ComUnregisterFunctionAttribute na metody s odpovídajícím podpisem.

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

Poznámky

Tento atribut můžete použít na metody.

ComRegisterFunctionAttribute umožňuje přidat libovolný registrační kód tak, aby vyhovoval požadavkům klientů MODELU COM. Registr můžete například aktualizovat pomocí registračních funkcí z oboru názvů Microsoft.Win32. Pokud zadáte metodu registrace, měli byste také použít System.Runtime.InteropServices.ComUnregisterFunctionAttribute metodu zrušení registrace, která obrátí operace provedené v metodě registrace.

.NET Framework: Modul CLR (Common Language Runtime) volá metodu s tímto atributem, pokud je její sestavení registrováno (přímo nebo nepřímo) pomocí nástroje Regasm.exe (Registrace sestavení) nebo prostřednictvím metody RegistrationServices.RegisterAssembly.

.NET Core: Modul CLR (Common Language Runtime) volá metodu s tímto atributem při registraci hostitele modelu COM obsahujícího sestavení prostřednictvím nástroje RegSvr32.exe.

Tento atribut lze použít pouze u metod, které mají následující charakteristiky:

• Rozsah: Libovolný (veřejný, soukromý atd.).

• Typ: static.

• Parametry: Přijímá jeden Type parametr nebo typ parametru String .

• Návratový typ: void.

Konstruktory

Name	Description
ComRegisterFunctionAttribute()	Inicializuje novou instanci ComRegisterFunctionAttribute třídy.

Vlastnosti

Name	Description
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní. (Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute)

Viz také

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (nástroj pro registraci sestavení)