ComAwareEventInfo.AddEventHandler(Object, Delegate) Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origine:

ComAwareEventInfo.cs

Associa un gestore dell'evento a un oggetto 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)

Parametri

target

Object

Oggetto di destinazione al quale deve essere associato il delegato dell'evento.

handler

Delegate

Delegato dell'evento.

Attributi

SupportedOSPlatformAttribute

Commenti

Questo metodo è simile al EventInfo.AddEventHandler(Object, Delegate) metodo, ad eccezione del fatto che consente di associare eventi agli oggetti COM.

Se target è un oggetto COM, questo metodo aggiunge un delegato a un evento usando il ComEventsHelper.Combine(Object, Guid, Int32, Delegate) metodo .

AddEventHandler facilita la registrazione dei sink di eventi COM che inoltrano chiamate ai delegati gestiti corrispondenti. Richiede le informazioni seguenti:

• Oggetto di destinazione (target).

• GUID dell'interfaccia di origine.

• DispID del metodo nell'interfaccia COM che corrisponde all'evento specificato.

• Delegato richiamato quando l'oggetto COM attiva l'evento corrispondente (handler).

AddEventHandler cerca l'interfaccia di origine COM corrispondente (specificata come primo parametro del ComEventInterfaceAttribute.ComEventInterfaceAttribute(Type, Type) costruttore). Cerca quindi un metodo nell'interfaccia di origine il cui nome è identico al nome dell'evento. Il valore dell'interfaccia di GuidAttribute origine è il GUID passato a ComEventsHelper.Combine(Object, Guid, Int32, Delegate). Il valore di DispIDAttribute nel metodo è il valore DispID passato a ComEventsHelper.Combine(Object, Guid, Int32, Delegate).