ComAwareEventInfo.AddEventHandler(Object, Delegate) Метод

Определение

Присоединяет обработчик событий к com-объекту.

public:
 override void AddEventHandler(System::Object ^ target, Delegate ^ handler);
public override void AddEventHandler(object target, Delegate handler);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public override void AddEventHandler(object target, Delegate handler);
override this.AddEventHandler : obj * Delegate -> unit
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
override this.AddEventHandler : obj * Delegate -> unit
Public Overrides Sub AddEventHandler (target As Object, handler As Delegate)

Параметры

target
Object

Целевой объект, к которому должен привязать делегат события.

handler
Delegate

Делегат события.

Атрибуты

Комментарии

Этот метод аналогичен методу EventInfo.AddEventHandler(Object, Delegate) , за исключением того, что он позволяет подключать события к COM-объектам.

Если target это COM-объект, этот метод добавляет делегат в событие с помощью ComEventsHelper.Combine(Object, Guid, Int32, Delegate) метода.

AddEventHandler упрощает регистрацию приемников событий COM, которые перенаправляют вызовы соответствующим управляемым делегатам. Для этого требуется следующая информация:

  • Сам целевой объект (target).

  • GUID исходного интерфейса.

  • DispID метода в com-интерфейсе, соответствующем указанному событию.

  • Делегат, который будет вызываться, когда com-объект активирует соответствующее событие (handler).

AddEventHandler ищет соответствующий интерфейс COM-источника (указанный в качестве первого параметра конструктора ComEventInterfaceAttribute.ComEventInterfaceAttribute(Type, Type) ). Затем он ищет метод в исходном интерфейсе, имя которого идентично имени события. Значение GuidAttribute в исходном интерфейсе — это GUID, передаваемый ComEventsHelper.Combine(Object, Guid, Int32, Delegate)в; значение DispIDAttribute метода — значение DispID, переданное в ComEventsHelper.Combine(Object, Guid, Int32, Delegate).

Применяется к