ComRegisterFunctionAttribute-Klasse

Artikel
04/20/2017

Veröffentlicht: Oktober 2016

Gibt die Methode aufrufen, wenn Sie eine Assembly für die Verwendung durch COM registrieren. Dies ermöglicht die Ausführung von Benutzercode während der Registrierung.

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

Vererbungshierarchie

System.Object
System.Attribute
System.Runtime.InteropServices.ComRegisterFunctionAttribute

Syntax

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

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

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Method, Inherited = false)>]
[<ComVisibleAttribute(true)>]
type ComRegisterFunctionAttribute = 
    class
        inherit Attribute
    end

<AttributeUsageAttribute(AttributeTargets.Method, Inherited := False)>
<ComVisibleAttribute(True)>
Public NotInheritable Class ComRegisterFunctionAttribute
    Inherits Attribute

Konstruktoren

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

Eigenschaften

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

Methoden

	Name	Beschreibung
	Equals(Object)	Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. 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)	Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)
	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 deren Hilfe 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)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

Hinweise

Sie können dieses Attribut auf Methoden anwenden.

ComRegisterFunctionAttribute können Sie beliebige Registrierungscode entsprechend die Anforderungen der COM-Clients hinzufügen. Sie können z. B. aktualisieren die Registrierung mithilfe der Registrierungsfunktionen aus dem Microsoft.Win32 Namespace. Wenn Sie eine Registrierungsmethode bereitstellen, müssen Sie auch anwenden System.Runtime.InteropServices.ComUnregisterFunctionAttribute an eine Methode zum Aufheben der Registrierung kehrt die Operationen der Registrierungsmethode durchgeführt.

Die common Language Runtime Ruft die Methode mit diesem Attribut, wenn deren enthaltende Assembly (direkt oder indirekt) registriert wird die Regasm.exe (Assembly Registration Tool)oder über die RegistrationServices.RegisterAssembly Methode.

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

Bereich: Beliebig (öffentlich, privat usw.).
Typ: static.
Parameter: Akzeptiert einen einzelnen Type Parameter oder ein String Parametertyp.
Rückgabetyp: void.

Beispiele

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

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

};

Versionsinformationen

.NET Framework
Verfügbar seit 1.1

Threadsicherheit

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Siehe auch

ComUnregisterFunctionAttribute
RegisterAssembly
System.Runtime.InteropServices-Namespace
Regasm.exe (Assembly Registration Tool)

Zurück zum Anfang

Freigeben über