ComAwareEventInfo.RemoveEventHandler(Object, Delegate) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Kaynak:

ComAwareEventInfo.cs

Bir olay işleyicisini COM nesnesinden ayırır.

public:
 override void RemoveEventHandler(System::Object ^ target, Delegate ^ handler);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public override void RemoveEventHandler (object target, Delegate handler);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
override this.RemoveEventHandler : obj * Delegate -> unit

Public Overrides Sub RemoveEventHandler (target As Object, handler As Delegate)

Parametreler

target

Object

Olay temsilcisinin bağlı olduğu hedef nesne.

handler

Delegate

Olay temsilcisi.

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

InvalidOperationException

Olayın ortak remove erişimcisi yok.

ArgumentException

geçirilen işleyici kullanılamaz.

TargetException

target parametresidir null ve olay statik değildir.

-veya-

EventInfo hedefte bildirilmemiş.

Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine yakalayın Exception .

MethodAccessException

Çağıranın üyeye erişim izni yok.

Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu MemberAccessExceptionyakalayın.

Açıklamalar

Bu yöntem yöntemine EventInfo.RemoveEventHandler(Object, Delegate) benzer, ancak olayları COM nesnelerinden ayırmanıza izin verir.

Bir COM nesnesiyse target , bu yöntem yöntemini kullanarak bir olaya temsilciyi ComEventsHelper.Remove(Object, Guid, Int32, Delegate) serbest bırakır.

RemoveEventHandler , çağrıları ilgili yönetilen temsilcilere ileden COM olay havuzlarının kaydını kaldırmayı kolaylaştırır. Aşağıdaki bilgileri gerektirir:

• Hedef nesnenin kendisi (target).

• Kaynak arabirimin GUID'i.

• Com arabiriminde belirtilen olaya karşılık gelen yönteminin DispID değeri.

• COM nesnesi karşılık gelen olayı (handler ) tetiklediğinde çağrılacak temsilci.

RemoveEventHandler karşılık gelen COM kaynak arabirimini arar (oluşturucunun ilk parametresi ComEventInterfaceAttribute.ComEventInterfaceAttribute(Type, Type) olarak belirtilir). Ardından kaynak arabirimde adı olay adıyla aynı olan bir yöntem arar. Kaynak arabirimdeki değeri GuidAttribute , öğesine ComEventsHelper.Remove(Object, Guid, Int32, Delegate)geçirilen GUID değeridir; yöntemindeki değeri DispIDAttribute , öğesine ComEventsHelper.Remove(Object, Guid, Int32, Delegate)geçirilen DispID değeridir.