Question

I started with a question, and in typing the question, found the answer, but instead of deleting, I thought it might be helpful to A) get confirmation, and B) help others.

If I have an event, and several places in the application add listeners, what is the best way to remove all listeners at once? For example, I can …

myPage.OnPageOpened += OpenPage;

and later in my code …

myPage.OnPageOpened -= OpenPage;

But what if I have unknown 3rd party subscribers and I want to press a magic Reset button that clears everything and starts from scratch?

You can use += and -= operators anywhere against the EventHandler, because the operator overloads are public. The = overloaded operator is private it can only be called in the defining class.

So in the defining class I can use this to clear my EventHandler.

OnPageOpened = null;

And to expose that functionality, I could …

public void ClearPageOpenedEvents() {
   OnPageOpened = null;
}

Is that correct?

Answer 1

Yes, you are correct. The reason for this is that the compiler creates a private delegate object under the covers, like this:

private EventHandler pageOpened;

public EventHandler PageOpened
{
    add { pageOpened += value; }
    remove { pageOpened -= value; }
}

Inside your class, you have a reference to the private delegate instance, so that’s why you can do the assignment. You definitely want to expose a method to clear the targets if that’s functionality you need; you don’t want to expose the delegate itself.