ComAwareEventInfo.AddEventHandler(Object, Delegate) Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Zdroj:

ComAwareEventInfo.cs

Připojí obslužnou rutinu události k objektu 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)

Parametry

target

Object

Cílový objekt, ke kterému má delegát události vytvořit vazbu.

handler

Delegate

Delegát události.

Atributy

SupportedOSPlatformAttribute

Poznámky

Tato metoda je podobná metodě s tím rozdílem EventInfo.AddEventHandler(Object, Delegate) , že umožňuje připojit události k objektům COM.

Pokud target je objekt COM, tato metoda přidá delegáta k události pomocí ComEventsHelper.Combine(Object, Guid, Int32, Delegate) metody.

AddEventHandler usnadňuje registraci jímek událostí modelu COM, které přesměrovává volání odpovídajícím spravovaným delegátům. Vyžaduje následující informace:

• Samotný cílový objekt (target).

• Identifikátor GUID zdrojového rozhraní.

• DispID metody v rozhraní COM, který odpovídá zadané události.

• Delegát, který by byl vyvolán, když objekt COM aktivuje odpovídající událost (handler).

AddEventHandler vyhledá odpovídající zdrojové rozhraní modelu COM (zadané jako první parametr konstruktoru ComEventInterfaceAttribute.ComEventInterfaceAttribute(Type, Type) ). Pak vyhledá metodu ve zdrojovém rozhraní, jehož název je identický s názvem události. Hodnota GuidAttribute na zdrojovém rozhraní je IDENTIFIKÁTOR GUID, který je předán ComEventsHelper.Combine(Object, Guid, Int32, Delegate); hodnota metody DispIDAttribute je DispID hodnota, která je předána ComEventsHelper.Combine(Object, Guid, Int32, Delegate).