ComEventInterfaceAttribute Klasse

Definition

Warnung

Diese API ist jetzt veraltet.

Identifiziert die Quellschnittstelle und die Klasse, die die Methoden der Ereignisschnittstelle implementiert, die beim Importieren einer Co-Klasse aus einer COM-Typbibliothek generiert wird.Identifies the source interface and the class that implements the methods of the event interface that is generated when a coclass is imported from a COM type library.

public ref class ComEventInterfaceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Obsolete("ComEventInterfaceAttribute may be unavailable in future releases.")]
public sealed class ComEventInterfaceAttribute : Attribute
type ComEventInterfaceAttribute = class
    inherit Attribute
Public NotInheritable Class ComEventInterfaceAttribute
Inherits Attribute
Vererbung
ComEventInterfaceAttribute
Attribute

Hinweise

Sie können dieses Attribut auf Schnittstellen anwenden, obwohl das " Tlbimp. exe" (Typbibliotheks Import Programm) es in der Regel für Sie anwendet, wenn es eine Typbibliothek importiert.You can apply this attribute to interfaces, although the Tlbimp.exe (Type Library Importer) typically applies it for you when it imports a type library.

Wenn eine Quell Schnittstelle aus einer Typbibliothek importiert wird, werden alle von ihr implementierten Methoden als Ereignisse zu einer generierten Ereignis Schnittstelle hinzugefügt.When a source interface is imported from a type library, any methods it implements are added as events to a generated event interface. "Tlbimp. exe ComEventInterfaceAttribute " gilt für die Ereignis Schnittstelle, um die verwaltete Klasse zu identifizieren, die die Methoden der Ereignis Schnittstelle implementiert und die ursprüngliche Quell Schnittstelle implementiert.Tlbimp.exe applies ComEventInterfaceAttribute to the event interface to identify the managed class that implements the methods of the event interface and implements the original source interface. Der Common Language Runtime verwendet dieses Attribut zur Laufzeit, um die folgenden Aufgaben auszuführen:The common language runtime uses this attribute at run time to perform the following tasks:

  • Ordnen Sie Ereignisse, die von der-Schnittstelle verfügbar gemacht werden, ihrer Implementierung in der Ereignis Anbieter Klasse zuAssociate events exposed by the interface to their implementation in the event provider class.

  • Verknüpfen Sie die Ereignisse mit der ursprünglichen com-Quell Schnittstelle.Link the events to the original COM source interface.

Dieses Attribut wird nur selten angewendet.You rarely apply this attribute. Wenn Sie jedoch beabsichtigen, Quellcode zu schreiben, der Metadaten erzeugt, die die von "Tlbimp. exe" erstellten Metadaten genau simulieren, sollten Sie eine-Ereignis Schnittstelle für jede ursprüngliche Quell Schnittstelle erstellen.However, if you plan to write source code that produces metadata that closely simulates metadata produced by Tlbimp.exe, you should create a event interface for each original source interface. Eine ausführliche Beschreibung dazu, wie "Tlbimp. exe" Ereignisse importiert, finden Sie unter importierenvon Membern.For a detailed description about how Tlbimp.exe imports events, see Imported Member Conversion. Anweisungen dazu, wie ein com-Ereignis für einen .NET-Client verfügbar gemacht wird, finden Sie unter Gewusst wie: Behandelt Ereignisse, die von einer com-Quelle ausgelöst werden.For instruction about how to expose a COM event to a .NET client, see How to: Handle Events Raised by a COM Source.

Konstruktoren

ComEventInterfaceAttribute(Type, Type)

Initialisiert eine neue Instanz der ComEventInterfaceAttribute-Klasse mit der Quellschnittstellen- und der Ereignisanbieterklasse.Initializes a new instance of the ComEventInterfaceAttribute class with the source interface and event provider class.

Eigenschaften

EventProvider

Ruft die Klasse ab, die die Methoden der Ereignisschnittstelle implementiert.Gets the class that implements the methods of the event interface.

SourceInterface

Ruft die ursprüngliche Quellschnittstelle aus der Typbibliothek ab.Gets the original source interface from the type library.

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Geerbt von Attribute)

Methoden

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Geerbt von Attribute)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(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.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Geerbt von Attribute)

Gilt für:

Siehe auch