ComEventInterfaceAttribute Classe

Référence

Définition

Espace de noms:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Attention

ComEventInterfaceAttribute may be unavailable in future releases.

Identifie l'interface source et la classe implémentant les méthodes de l'interface d'événement qui est générée quand une coclasse est importée à partir d'une bibliothèque de types COM.

public ref class ComEventInterfaceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
[System.Obsolete("ComEventInterfaceAttribute may be unavailable in future releases.")]
public sealed class ComEventInterfaceAttribute : Attribute

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

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

[<System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)>]
[<System.Obsolete("ComEventInterfaceAttribute may be unavailable in future releases.")>]
type ComEventInterfaceAttribute = class
    inherit Attribute

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

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

Public NotInheritable Class ComEventInterfaceAttribute
Inherits Attribute

Héritage: Object

Attribute
ComEventInterfaceAttribute

Attributs: AttributeUsageAttribute ObsoleteAttribute ComVisibleAttribute

Remarques

Vous pouvez appliquer cet attribut aux interfaces, bien que le Tlbimp.exe (Importateur de bibliothèque de types) l’applique généralement quand il importe une bibliothèque de types.

Lorsqu’une interface source est importée à partir d’une bibliothèque de types, toutes les méthodes qu’elle implémente sont ajoutées en tant qu’événements à une interface d’événement générée. Tlbimp.exe s’applique ComEventInterfaceAttribute à l’interface d’événement pour identifier la classe managée qui implémente les méthodes de l’interface d’événement et implémente l’interface source d’origine. Le Common Language Runtime utilise cet attribut au moment de l’exécution pour effectuer les tâches suivantes :

Associez les événements exposés par l’interface à leur implémentation dans la classe du fournisseur d’événements.
Liez les événements à l’interface source COM d’origine.

Vous appliquez rarement cet attribut. Toutefois, si vous envisagez d’écrire du code source qui produit des métadonnées qui simulent étroitement les métadonnées produites par Tlbimp.exe, vous devez créer une interface d’événement pour chaque interface source d’origine. Pour obtenir une description détaillée de la façon dont Tlbimp.exe importe des événements, consultez Conversion de membre importé. Pour obtenir des instructions sur la façon d’exposer un événement COM à un client .NET, consultez Guide pratique pour gérer les événements déclenchés par une source COM.

Constructeurs

ComEventInterfaceAttribute(Type, Type)

Initialise une nouvelle instance de la classe ComEventInterfaceAttribute avec l'interface source et la classe du fournisseur d'événements.

Propriétés

EventProvider	Obtient la classe qui implémente les méthodes de l'interface d'événement.
SourceInterface	Obtient l'interface source d'origine de la bibliothèque de types.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)

S’applique à

Voir aussi

Tlbimp.exe (Type Library Importer)