ComAwareEventInfo.AddEventHandler(Object, Delegate) Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Source:

ComAwareEventInfo.cs

Joint un gestionnaire d’événements à un objet COM.

public:
 override void AddEventHandler(System::Object ^ target, Delegate ^ handler);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public override void AddEventHandler (object target, Delegate handler);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
override this.AddEventHandler : obj * Delegate -> unit

Public Overrides Sub AddEventHandler (target As Object, handler As Delegate)

Paramètres

target

Object

Objet cible avec lequel le délégué d’événement doit créer une liaison.

handler

Delegate

Délégué d’événement.

Attributs

SupportedOSPlatformAttribute

Remarques

Cette méthode est similaire à la EventInfo.AddEventHandler(Object, Delegate) méthode, sauf qu’elle vous permet d’attacher des événements à des objets COM.

Si target est un objet COM, cette méthode ajoute un délégué à un événement à l’aide de la ComEventsHelper.Combine(Object, Guid, Int32, Delegate) méthode .

AddEventHandler facilite l’inscription des récepteurs d’événements COM qui transfèrent les appels aux délégués managés correspondants. Elle nécessite les informations suivantes :

• Objet cible lui-même (target).

• GUID de l’interface source.

• DispID de la méthode sur l’interface COM qui correspond à l’événement spécifié.

• Délégué qui serait appelé lorsque l’objet COM déclenche l’événement correspondant (handler).

AddEventHandler recherche l’interface source COM correspondante (spécifiée comme premier paramètre du ComEventInterfaceAttribute.ComEventInterfaceAttribute(Type, Type) constructeur). Il recherche ensuite une méthode sur l’interface source dont le nom est identique au nom de l’événement. La valeur de GuidAttribute sur l’interface source est le GUID qui est passé à ComEventsHelper.Combine(Object, Guid, Int32, Delegate); la valeur de DispIDAttribute sur la méthode est la valeur DispID qui est passée à ComEventsHelper.Combine(Object, Guid, Int32, Delegate).