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 genel 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, COM nesnelerinden olayları ayırmanıza izin vermesi dışında yöntemine benzer EventInfo.RemoveEventHandler(Object, Delegate) .

BIR COM nesnesiyse target , bu yöntem yöntemini kullanarak bir olaya temsilci serbest ComEventsHelper.Remove(Object, Guid, Int32, Delegate) 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 arabiriminin GUID değeri.

• Belirtilen olaya karşılık gelen COM arabiriminde 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'dir; yöntemindeki değeri DispIDAttribute , öğesine geçirilen ComEventsHelper.Remove(Object, Guid, Int32, Delegate)DispID değeridir.