ComAwareEventInfo.RemoveEventHandler(Object, Delegate) Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

netstandard.dll, System.Runtime.InteropServices.dll

Sumber:

ComAwareEventInfo.cs

Mencopot penanganan aktivitas dari objek COM.

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)

Parameter

target

Object

Objek target tempat delegasi peristiwa terikat.

handler

Delegate

Delegasi peristiwa.

Atribut

SupportedOSPlatformAttribute

Pengecualian

InvalidOperationException

Kejadian ini tidak memiliki aksesor publik remove .

ArgumentException

Handler yang diteruskan tidak dapat digunakan.

TargetException

Parameternya target adalah null dan peristiwanya tidak statis.

-atau-

EventInfo tidak dinyatakan pada target.

MethodAccessException

Pemanggil tidak memiliki izin akses ke anggota.

Keterangan

Metode ini mirip EventInfo.RemoveEventHandler(Object, Delegate) dengan metode , kecuali memungkinkan Anda untuk melepaskan peristiwa dari objek COM.

Jika target adalah objek COM, metode ini merilis delegasi ke suatu peristiwa dengan menggunakan ComEventsHelper.Remove(Object, Guid, Int32, Delegate) metode .

RemoveEventHandler memfasilitasi membatalkan pendaftaran sink peristiwa COM yang meneruskan panggilan ke delegasi terkelola yang sesuai. Ini memerlukan informasi berikut:

• Objek target itu sendiri (target).

• GUID antarmuka sumber.

• DispID metode pada antarmuka COM yang sesuai dengan peristiwa yang ditentukan.

• Delegasi yang akan dipanggil ketika objek COM memicu peristiwa yang sesuai (handler).

RemoveEventHandler mencari antarmuka sumber COM yang sesuai (ditentukan sebagai parameter ComEventInterfaceAttribute.ComEventInterfaceAttribute(Type, Type) pertama konstruktor). Kemudian ia mencari metode pada antarmuka sumber yang namanya identik dengan nama peristiwa. Nilai GuidAttribute pada antarmuka sumber adalah GUID yang diteruskan ke ComEventsHelper.Remove(Object, Guid, Int32, Delegate); nilai DispIDAttribute pada metode adalah nilai DispID yang diteruskan ke ComEventsHelper.Remove(Object, Guid, Int32, Delegate).