ComUnregisterFunctionAttribute-Klasse

Artikel
08/20/2007

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.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Method, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class ComUnregisterFunctionAttribute
    Inherits Attribute
'Usage
Dim instance As ComUnregisterFunctionAttribute

[AttributeUsageAttribute(AttributeTargets.Method, Inherited=false)] 
[ComVisibleAttribute(true)] 
public sealed class ComUnregisterFunctionAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Method, Inherited=false)] 
[ComVisibleAttribute(true)] 
public ref class ComUnregisterFunctionAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Method, Inherited=false) */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class ComUnregisterFunctionAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Method, Inherited=false) 
ComVisibleAttribute(true) 
public final class ComUnregisterFunctionAttribute extends Attribute

Hinweise

Dieses Attribut kann auf Methoden angewendet werden.

ComUnregisterFunctionAttribute ermöglicht Ihnen das Hinzufügen von Code, der die von einer Registrierungsmethode durchgeführten Vorgänge rückgängig macht. Wenn Sie ComRegisterFunctionAttribute anwenden, um eine Registrierungsmethode anzugeben, müssen Sie auch eine Methode zum Aufheben der Registrierung angeben, um die ausgeführten Operationen der Registrierungsmethode rückgängig zu machen. Sie können für eine Klasse nur eine Methode zum Aufheben der Registrierung angeben.

Die Common Language Runtime ruft die Methode mit diesem Attribut auf, wenn die Registrierung der sie enthaltenden Assembly (direkt oder indirekt) mit Assembly Registration-Tool (Regasm.exe) oder über die RegistrationServices.UnregisterAssembly-API-Methode aufgehoben wird. Methoden mit diesem Attribut können eine beliebige Sichtbarkeit (öffentlich, privat usw.) aufweisen, sie müssen jedoch static sein und einen einzigen Type-Parameter zum Aufheben der Registrierung von Type akzeptieren.

Beispiel

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

Imports System
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

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.
   }
}

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.
   }

};

import System.*;
import System.Runtime.InteropServices.*;

public class MyClassThatNeedsToRegister
{
    /** @attribute ComRegisterFunctionAttribute()
     */
    public static void RegisterFunction(Type t)
    {
        //Insert code here.
    } //RegisterFunction

    /** @attribute ComUnregisterFunctionAttribute()
     */
    public static void UnregisterFunction(Type t)
    {
        //Insert code here.
    } //UnregisterFunction
} //MyClassThatNeedsToRegister

import System;
import System.Runtime.InteropServices;

public class MyClassThatNeedsToRegister
{
   ComRegisterFunctionAttribute public static function RegisterFunction(t : Type) : void 
   {
      //Insert code here.
   }
   
   ComUnregisterFunctionAttribute public static function UnregisterFunction(t : Type) : void
   {
      //Insert code here.
   }
}

Vererbungshierarchie

System.Object
System.Attribute
System.Runtime.InteropServices.ComUnregisterFunctionAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ComUnregisterFunctionAttribute-Member
System.Runtime.InteropServices-Namespace
ComRegisterFunctionAttribute-Klasse
RegistrationServices.UnregisterAssembly

Weitere Ressourcen

Assembly Registration-Tool (Regasm.exe)

Freigeben über