VectorListener.Destroy

Method

Visual Basic

Overrideable Public Sub Destroy()

C#

public virtual void Destroy();

Purpose

Destroy a listener, canceling interest.

Remarks

Destroying a vector listener cancels interest in its subject. Upon return from VectorListener.Destroy, the destroyed listener is no longer dispatched. However, all active event handlers of this listener continue to run and return normally, even though the listener is invalid.

It is legal for an event handler to destroy its own listener.

Destroying listener interest invalidates the listener object; subsequent API calls involving the invalid listener throw exceptions, unless explicitly documented to the contrary.