2 // System.ComponentModel.Component.cs
5 // Miguel de Icaza (miguel@ximian.com)
6 // Andreas Nahr (ClassDevelopment@A-SoftTech.com)
8 // (C) Ximian, Inc. http://www.ximian.com
9 // (C) 2003 Andreas Nahr
13 // Permission is hereby granted, free of charge, to any person obtaining
14 // a copy of this software and associated documentation files (the
15 // "Software"), to deal in the Software without restriction, including
16 // without limitation the rights to use, copy, modify, merge, publish,
17 // distribute, sublicense, and/or sell copies of the Software, and to
18 // permit persons to whom the Software is furnished to do so, subject to
19 // the following conditions:
21 // The above copyright notice and this permission notice shall be
22 // included in all copies or substantial portions of the Software.
24 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
27 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
28 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
29 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
30 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
34 using System.ComponentModel;
36 namespace System.ComponentModel {
38 [DesignerCategory ("Component")]
39 public class Component : MarshalByRefObject, IComponent, IDisposable
42 private EventHandlerList event_handlers;
44 private object disposedEvent = new object ();
48 event_handlers = null;
51 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
52 public IContainer Container {
56 return mySite.Container;
60 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
61 protected bool DesignMode {
65 return mySite.DesignMode;
69 protected EventHandlerList Events {
71 // Note: space vs. time tradeoff
72 // We create the object here if it's never be accessed before. This potentially
73 // saves space. However, we must check each time the propery is accessed to
74 // determine whether we need to create the object, which increases overhead.
75 // We could put the creation in the contructor, but that would waste space
76 // if it were never used. However, accessing this property would be faster.
77 if (null == event_handlers)
78 event_handlers = new EventHandlerList();
80 return event_handlers;
84 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
85 public virtual ISite Site {
86 get { return mySite; }
87 set { mySite = value; }
95 public void Dispose ()
98 GC.SuppressFinalize (this);
102 // Controls disposal of resources used by this.
105 // <param name="release_all"> Controls which resources are released</param>
108 // if release_all is set to true, both managed and unmanaged
109 // resources should be released. If release_all is set to false,
110 // only unmanaged resources should be disposed
112 protected virtual void Dispose (bool release_all)
115 EventHandler eh = (EventHandler) Events [disposedEvent];
117 eh (this, EventArgs.Empty);
122 protected virtual object GetService (Type service)
124 if (mySite != null) {
125 return mySite.GetService(service);
130 public override string ToString ()
133 return GetType ().ToString ();
134 return String.Format ("{0} [{1}]", mySite.Name, GetType ().ToString ());
137 [Browsable (false), EditorBrowsable (EditorBrowsableState.Advanced)]
138 public event EventHandler Disposed {
139 add { Events.AddHandler (disposedEvent, value); }
140 remove { Events.RemoveHandler (disposedEvent, value); }