ComUnregisterFunctionAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

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

public ref class ComUnregisterFunctionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class ComUnregisterFunctionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type ComUnregisterFunctionAttribute = class
    inherit Attribute

Public NotInheritable Class ComUnregisterFunctionAttribute
Inherits Attribute

Vererbung

Object

Attribute

ComUnregisterFunctionAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird das Anwenden von ComRegisterFunctionAttribute und ComUnregisterFunctionAttribute auf Methoden mit der entsprechenden Signatur veranschaulicht.

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.

ComUnregisterFunctionAttribute ermöglicht das Hinzufügen von Code, der die von einer Registrierungsmethode ausgeführten Vorgänge umkehrt. Wenn Sie die ComRegisterFunctionAttribute anwenden, um eine Registrierungsmethode bereitzustellen, sollten Sie auch eine Methode für die Aufhebung der Registrierung bereitstellen, um die in der Registrierungsmethode ausgeführten Vorgänge rückgängig zu machen. Sie können nur eine Methode zum Aufheben der Registrierung für eine Klasse verwenden.

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

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

Konstruktoren

ComUnregisterFunctionAttribute()

Initialisiert eine neue Instanz der ComUnregisterFunctionAttribute-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

• ComRegisterFunctionAttribute
• UnregisterAssembly(Assembly)
• Regasm.exe (Assembly Registration-Tool)