ComRegisterFunctionAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Gibt die Methode an, die beim Registrieren einer Assembly für die Verwendung durch COM aufgerufen werden muss. Dadurch kann während des Registrierungsvorgangs vom Benutzer erstellter Code ausgeführt werden.

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

Vererbung

Object

Attribute

ComRegisterFunctionAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie und ComUnregisterFunctionAttribute auf Methoden mit der entsprechenden Signatur angewendet ComRegisterFunctionAttribute 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. Beispielsweise können Sie die Registrierung mithilfe von Registrierungsfunktionen aus dem Microsoft.Win32 Namespace aktualisieren. Wenn Sie eine Registrierungsmethode angeben, sollten Sie auch auf eine Methode zum Aufheben der Registrierung anwenden System.Runtime.InteropServices.ComUnregisterFunctionAttribute , die die in der Registrierungsmethode ausgeführten Vorgänge umkehrt.

.NET Framework: Die Common Language Runtime ruft die -Methode mit diesem Attribut auf, wenn die enthaltende Assembly (direkt oder indirekt) beim toolRegasm.exe (Assemblyregistrierung) oder über die RegistrationServices.RegisterAssembly -Methode registriert wird.

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

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

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

• Geben Sie Folgendes ein: static.

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

• Rückgabetyp: void.

Konstruktoren

ComRegisterFunctionAttribute()

Initialisiert eine neue Instanz der ComRegisterFunctionAttribute-Klasse.

Eigenschaften

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (Assembly Registration-Tool)