ComRegisterFunctionAttribute Třída

Definice

Určuje metodu volat při registraci sestavení pro použití v modelu COM; To umožňuje spuštění uživatelem zapsaný kód během procesu registrace.Specifies the method to call when you register an assembly for use from COM; this enables the execution of user-written code during the registration process.

public ref class ComRegisterFunctionAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComRegisterFunctionAttribute : Attribute
type ComRegisterFunctionAttribute = class
    inherit Attribute
Public NotInheritable Class ComRegisterFunctionAttribute
Inherits Attribute
Dědičnost
ComRegisterFunctionAttribute
Atributy

Příklady

Následující příklad ukazuje, jak použít ComRegisterFunctionAttribute a ComUnregisterFunctionAttribute k metodám s odpovídajícím podpisem.The following example demonstrates how to apply ComRegisterFunctionAttribute and ComUnregisterFunctionAttribute to methods with the appropriate signature.

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

Můžete použít tento atribut do metody.You can apply this attribute to methods.

ComRegisterFunctionAttribute můžete přidat libovolný registrační kód tak, aby vyhovovaly požadavkům klientů modelu COM.ComRegisterFunctionAttribute enables you to add arbitrary registration code to accommodate the requirements of COM clients. Například můžete aktualizovat pomocí funkce registrace z registru Microsoft.Win32 oboru názvů.For example, you can update the registry using registration functions from the Microsoft.Win32 namespace. Pokud zadáte způsob registrace, měli byste také použít System.Runtime.InteropServices.ComUnregisterFunctionAttribute zrušení registrace metody, které obrátí operace provádí metoda registrace.If you provide a registration method, you should also apply System.Runtime.InteropServices.ComUnregisterFunctionAttribute to an unregistration method, which reverses the operations done in the registration method.

.NET Framework: Modul common language runtime zavolá metodu pomocí tohoto atributu při jeho obsažené sestavení není zaregistrována (přímo nebo nepřímo) nástroj Regasm.exe (Assembly Registration)) nebo prostřednictvím RegistrationServices.RegisterAssembly metody..NET Framework: The common language runtime calls the method with this attribute when its containing assembly is registered (directly or indirectly) with the Regasm.exe (Assembly Registration) tool) or through the RegistrationServices.RegisterAssembly method.

.NET Core: Modul common language runtime zavolá metodu pomocí tohoto atributu při registraci prostřednictvím hostitelů obsahující sestavení modelu COM RegSvr32.exe nástroj..NET Core: The common language runtime calls the method with this attribute when its containing assembly's COM host is registered via the RegSvr32.exe tool.

Tento atribut lze použít pouze pro metody, které mají následující vlastnosti:This attribute can be applied only to methods that have the following characteristics:

  • Obor: Všechny (veřejné, privátní a tak dále).Scope: Any (public, private, and so on).

  • Typ: static.Type: static.

  • Parametry: Přijímá jediný Type parametr nebo String typ parametru.Parameters: Accepts a single Type parameter or a String parameter type.

  • Návratový typ: void.Return type: void.

Konstruktory

ComRegisterFunctionAttribute()

Inicializuje novou instanci třídy ComRegisterFunctionAttribute třídy.Initializes a new instance of the ComRegisterFunctionAttribute class.

Vlastnosti

TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Zděděno od Attribute)

Metody

Equals(Object)

Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.Returns a value that indicates whether this instance is equal to a specified object.

(Zděděno od Attribute)
GetHashCode()

Vrátí kód hash této instance.Returns the hash code for this instance.

(Zděděno od Attribute)
GetType()

Type Získá aktuální instanci.Gets the Type of the current instance.

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Zděděno od Attribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda je tato instance rovna zadanému objektu.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří kopii aktuálního Objectseznamu.Creates a shallow copy of the current Object.

(Zděděno od Object)
ToString()

Vrací řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.Maps a set of names to a corresponding set of dispatch identifiers.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu pro objekt, který lze použít k získání informací o typu pro rozhraní.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Zděděno od Attribute)

Platí pro

Viz také