ComRegisterFunctionAttribute Třída

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Určuje metodu volání při registraci sestavení pro použití z com; to umožňuje spuštění kódu napsaného uživatelem během procesu registrace.

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)>]
type ComRegisterFunctionAttribute = class
    inherit Attribute

Public NotInheritable Class ComRegisterFunctionAttribute
Inherits Attribute

Dědičnost

Object

Attribute

ComRegisterFunctionAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad ukazuje, jak použít ComRegisterFunctionAttribute metody a ComUnregisterFunctionAttribute s příslušný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 u metod.

ComRegisterFunctionAttribute umožňuje přidat libovolný registrační kód, který bude vyhovovat požadavkům klientů modelu COM. Registr můžete například aktualizovat pomocí registračních funkcí z Microsoft.Win32 oboru názvů. Pokud zadáte metodu registrace, měli byste použít System.Runtime.InteropServices.ComUnregisterFunctionAttribute také 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í obsahující sestavení registrováno (přímo nebo nepřímo) pomocí nástrojeRegasm.exe (Registrace sestavení) nebo prostřednictvím RegistrationServices.RegisterAssembly metody.

.NET Core: Modul CLR (Common Language Runtime) volá metodu s tímto atributem, pokud je hostitel COM obsahujícího sestavení zaregistrován prostřednictvím nástrojeRegSvr32.exe.

Tento atribut lze použít pouze pro metody, které mají následující vlastnosti:

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

• Typ: static.

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

• Návratový typ: void.

Konstruktory

ComRegisterFunctionAttribute()

Inicializuje novou instanci ComRegisterFunctionAttribute třídy.

Vlastnosti

TypeId

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

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance 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á označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

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