Component

Component

marshal by reference, disposable

---

System.ComponentModel (system.dll)

class

This is the base for classes that can be hosted in a container such as those provided by the design-time environment. Note that it is a marshal-by-reference object. If you need marshal- by-value semantics, use MarshalByValueComponent .

You can obtain the Container that hosts the component and the Site that binds the component to the container. Derived classes also can use the protected DesignMode property to determine whether the class is hosted in a designer.

Note that the class implements the IDisposable interface. The Container ensures that the object is disposed correctly (if you have a Container , but you should ensure that your resource release code is added to the Dispose() method.

There are actually two dispose methods , and you would normally override the protected member that takes a Boolean. This is to support different cleanup behavior when Dispose() is called by the Container , and when it is called by the Component object's finalizer.

Typically, Component -derived classes are those non-windowed classes that you wish to present in the designer environment. They can use the GetService() method of the Site to make use of facilities provided by the designer host.

Classes that display a window should derive instead from System.Windows.Forms.Control , which itself derives from Component .

 public class  Component  : MarshalByRefObject : IComponent, IDisposable {  // Public Constructors  public  Component  ();  // Public Instance Properties  public IContainer  Container  {get; }    public virtual ISite  Site  {set; get; }  // implements IComponent   // Protected Instance Properties  protected bool  DesignMode  {get; }    protected EventHandlerList  Events  {get; }  // Public Instance Methods  public void  Dispose  ();  // implements IDisposable  public override string  ToString  ();  // overrides object   // Protected Instance Methods  protected virtual void  Dispose  (bool  disposing  );    protected override void  Finalize  ();  // overrides object  protected virtual object  GetService  (Type  service  );  // Events  public event EventHandler  Disposed  ;  // implements IComponent  } 

Hierarchy

System.Object System.MarshalByRefObject Component(IComponen, System.IDisposable)

Subclasses

Multiple types