How do I add Dispose functionality to a C# UserControl?

Question

I have a class which implements UserControl. In .NET 2005, a Dispose method is automatically created in the MyClass.Designer.cs partial class file that looks like this:

  protected override void Dispose(bool disposing)
  {
     if (disposing && (components != null))
     {
        components.Dispose();
     }
     base.Dispose(disposing);
  }

If I want to add my own Dispose functionality, where would I put it? Since this file is generated, I don't want to add code here and risk it getting blown away.

Answer 1

I believe in this case the code-generator honors your code. It should be safe to put it in the codebehind.

Answer 2

In VS 2005 (and 2008) you can update the Dispose method and it will not get removed when you edit the control from the designer.

Answer 3

You can move it out from the .designer.cs file and into the main .cs file if you want. As has been said already, it won't be overwritten.

Answer 4

In such a case I move the generated Dispose method to the main file and extend it. Visual Studio respects this.

An other approach would be using a partial method (C# 3.0).

Answer 5

All Component classes implement Disposed event. You can add event handler and clean up things.

Answer 6

You just need to overload the public void Dispose() method in the Component Class that the user control inherits.

make sure you pass the call to the base method as well as doing your dispose functionally or you'll break the functionality unless you fully implement it