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).