ComEventInterfaceAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Quelle:

ComEventInterfaceAttribute.cs

Identifiziert die Quellschnittstelle und die Klasse, die die Methoden der Ereignisschnittstelle implementiert, die beim Importieren einer Co-Klasse aus einer COM-Typbibliothek generiert wird.

public ref class ComEventInterfaceAttribute sealed : Attribute

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

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

Public NotInheritable Class ComEventInterfaceAttribute
Inherits Attribute

Vererbung

Object

Attribute

ComEventInterfaceAttribute

Attribute

AttributeUsageAttribute

Hinweise

Sie können dieses Attribut auf Schnittstellen anwenden, obwohl der Tlbimp.exe (Type Library Importer) es normalerweise für Sie anwendet, wenn eine Typbibliothek importiert wird.

Wenn eine Quellschnittstelle aus einer Typbibliothek importiert wird, werden alle von ihr implementierten Methoden als Ereignisse zu einer generierten Ereignisschnittstelle hinzugefügt. Tlbimp.exe gilt für ComEventInterfaceAttribute die Ereignisschnittstelle, um die verwaltete Klasse zu identifizieren, die die Methoden der Ereignisschnittstelle implementiert und die ursprüngliche Quellschnittstelle implementiert. Die Common Language Runtime verwendet dieses Attribut zur Laufzeit, um die folgenden Aufgaben auszuführen:

• Ordnen Sie ereignisse, die von der Schnittstelle verfügbar gemacht werden, ihrer Implementierung in der Ereignisanbieterklasse zu.

• Verknüpfen Sie die Ereignisse mit der ursprünglichen COM-Quellschnittstelle.

Dieses Attribut wird selten angewendet. Wenn Sie jedoch Quellcode schreiben möchten, der Metadaten erzeugt, die von Tlbimp.exe erzeugte Metadaten genau simulieren, sollten Sie eine Ereignisschnittstelle für jede ursprüngliche Quellschnittstelle erstellen. Eine ausführliche Beschreibung darüber, wie Tlbimp.exe Ereignisse importiert, finden Sie unter Importierte Memberkonvertierung. Anweisungen zum Verfügbarmachen eines COM-Ereignisses für einen .NET-Client finden Sie unter Vorgehensweise: Behandeln von Ereignissen, die von einer COM-Quelle ausgelöst werden.

Konstruktoren

ComEventInterfaceAttribute(Type, Type)

Initialisiert eine neue Instanz der ComEventInterfaceAttribute-Klasse mit der Quellschnittstellen- und der Ereignisanbieterklasse.

Eigenschaften

EventProvider	Ruft die Klasse ab, die die Methoden der Ereignisschnittstelle implementiert.
SourceInterface	Ruft die ursprüngliche Quellschnittstelle aus der Typbibliothek ab.
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

• Tlbimp.exe (Type Library Importer-Tool)