ComRegisterFunctionAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Gibt die Methode an, die aufgerufen werden soll, wenn Sie eine Assembly für die Verwendung von COM registrieren; dies ermöglicht die Ausführung von vom Benutzer geschriebenen Code während des Registrierungsprozesses.

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

Vererbung

Object

Attribute

ComRegisterFunctionAttribute

Attribute

AttributeUsageAttribute ComVisibleAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Methoden mit der entsprechenden Signatur angewendet ComRegisterFunctionAttribute und ComUnregisterFunctionAttribute angewendet werden.

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

Hinweise

Sie können dieses Attribut auf Methoden anwenden.

ComRegisterFunctionAttribute ermöglicht es Ihnen, beliebigen Registrierungscode hinzuzufügen, um die Anforderungen von COM-Clients zu erfüllen. Sie können die Registrierung beispielsweise mithilfe von Registrierungsfunktionen aus dem namespace Microsoft.Win32 aktualisieren. Wenn Sie eine Registrierungsmethode angeben, sollten Sie auch auf eine Unregistration-Methode anwenden System.Runtime.InteropServices.ComUnregisterFunctionAttribute , wodurch die vorgänge in der Registrierungsmethode rückgängig gemacht werden.

.NET Framework: Die Common Language Runtime ruft die Methode mit diesem Attribut auf, wenn die enthaltende Assembly (direkt oder indirekt) mit dem Tool Regasm.exe (Assembly Registration) registriert ist) oder über die methode RegistrationServices.RegisterAssembly.

.NET Core: Die Common Language Runtime ruft die Methode mit diesem Attribut auf, wenn der COM-Host der zugehörigen Assembly über das Tool RegSvr32.exe registriert wird.

Dieses Attribut kann nur auf Methoden angewendet werden, die die folgenden Merkmale aufweisen:

• Bereich: Beliebig (öffentlich, privat usw.).

• Typ: static.

• Parameter: Akzeptiert einen einzelnen Type Parameter oder einen String Parametertyp.

• Rückgabetyp: void.

Konstruktoren

Name	Beschreibung
ComRegisterFunctionAttribute()	Initialisiert eine neue Instanz der ComRegisterFunctionAttribute-Klasse.

Eigenschaften

Name	Beschreibung
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)

Methoden

Name	Beschreibung
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute)

Weitere Informationen

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (Assemblyregistrierungstool)