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

Определение

Отсоединяет обработчик событий от COM-объекта.

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

Параметры

target
Object

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

handler
Delegate

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

Атрибуты

Исключения

Это событие не поддерживает открытый метод доступа remove.

Переданный обработчик нельзя использовать.

Параметр target имеет значение null, и событие не является статическим.

-или-

Класс EventInfo не объявлен для целевого объекта.

Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов выполните перехват Exception .

Вызывающий объект не имеет разрешения на доступ к этому элементу.

Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов перехватите исключение MemberAccessExceptionбазового класса , .

Комментарии

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

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

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

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

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

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

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

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

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