ComAwareEventInfo.AddEventHandler(Object, Delegate) Méthode

Définition

Espace de noms:
System.Runtime.InteropServices
Assemblys:
System.Core.dll, System.Runtime.InteropServices.dll
Assembly:
System.Core.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
netstandard.dll

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

public:
 override void AddEventHandler(System::Object ^ target, Delegate ^ handler);
public override void AddEventHandler(object target, Delegate handler);
override this.AddEventHandler : obj * Delegate -> unit
abstract member AddEventHandler : obj * Delegate -> unit
override this.AddEventHandler : obj * Delegate -> unit
Public Overrides Sub AddEventHandler (target As Object, handler As Delegate)

Paramètres

target
Object

Objet cible auquel le délégué d’événement doit se lier.

handler
Delegate

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

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.

S’il target s’agit d’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. Il 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 l’interface source est le GUID passé à ComEventsHelper.Combine(Object, Guid, Int32, Delegate); la valeur de DispIDAttribute la méthode est la valeur DispID passée à ComEventsHelper.Combine(Object, Guid, Int32, Delegate).

S’applique à