ComEventInterfaceAttribute-Klasse
Bezeichnet die Quellschnittstelle und die Klasse zum Implementieren der Methoden der Ereignisschnittstelle, die beim Importieren einer Co-Klasse aus einer COM-Typbibliothek generiert wird.
Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<AttributeUsageAttribute(AttributeTargets.Interface, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class ComEventInterfaceAttribute
Inherits Attribute
'Usage
Dim instance As ComEventInterfaceAttribute
[AttributeUsageAttribute(AttributeTargets.Interface, Inherited=false)]
[ComVisibleAttribute(true)]
public sealed class ComEventInterfaceAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Interface, Inherited=false)]
[ComVisibleAttribute(true)]
public ref class ComEventInterfaceAttribute sealed : public Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Interface, Inherited=false) */
/** @attribute ComVisibleAttribute(true) */
public final class ComEventInterfaceAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Interface, Inherited=false)
ComVisibleAttribute(true)
public final class ComEventInterfaceAttribute extends Attribute
Hinweise
Sie können dieses Attribut auf Schnittstellen anwenden, obwohl es beim Importieren einer Typbibliothek von Type Library Importer-Tool (Tlbimp.exe) normalerweise automatisch angewendet wird.
Wenn eine Quellschnittstelle aus einer Typbibliothek importiert wird, werden sämtliche von ihr implementierten Methoden einer generierten Ereignisschnittstelle als Ereignisse hinzugefügt. Tlbimp.exe wendet ComEventInterfaceAttribute auf die Ereignisschnittstelle an, um die verwaltete Klasse zu bestimmen, von der die Methoden der Ereignisschnittstelle implementiert werden, und implementiert die ursprüngliche Quellschnittstelle. Die Common Language Runtime führt mit diesem Attribut zur Laufzeit die folgenden Aufgaben aus:
Zuordnen der von der Schnittstelle verfügbar gemachten Ereignisse zu ihrer Implementierung in der Ereignisproviderklasse.
Verknüpfen der Ereignisse mit der ursprünglichen COM-Quellschnittstelle.
Dieses Attribut wird selten angewendet. Wenn Sie jedoch Quellcode zum Erzeugen von Metadaten schreiben möchten, die von Tlbimp.exe erzeugte Metadaten nahezu simulieren, empfiehlt es sich, für jede ursprüngliche Quellschnittstelle eine Ereignisschnittstelle zu erstellen. Eine ausführliche Beschreibung des Importierens von Ereignissen durch Tlbimp.exe finden Sie unter Konvertieren importierter Member. Anleitungen zum Verfügbarmachen eines COM-Ereignisses für einen .NET-Client finden Sie unter Gewusst wie: Behandeln von Ereignissen, die durch eine COM-Quelle ausgelöst wurden.
Vererbungshierarchie
System.Object
System.Attribute
System.Runtime.InteropServices.ComEventInterfaceAttribute
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 CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
ComEventInterfaceAttribute-Member
System.Runtime.InteropServices-Namespace