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;
35 using System.Runtime.InteropServices;
37 namespace System.ComponentModel {
39 [DesignerCategory ("Component")]
41 [ClassInterface (ClassInterfaceType.AutoDispatch)]
42 public class Component : MarshalByRefObject, IComponent, IDisposable
45 private EventHandlerList event_handlers;
47 static readonly object disposedEvent = new object ();
51 event_handlers = null;
54 protected virtual bool CanRaiseEvents {
58 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
59 public virtual ISite Site
61 get { return mySite; }
62 set { mySite = value; }
65 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
66 public IContainer Container {
70 return mySite.Container;
74 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
75 protected bool DesignMode {
79 return mySite.DesignMode;
83 protected EventHandlerList Events {
85 // Note: space vs. time tradeoff
86 // We create the object here if it's never be accessed before. This potentially
87 // saves space. However, we must check each time the propery is accessed to
88 // determine whether we need to create the object, which increases overhead.
89 // We could put the creation in the contructor, but that would waste space
90 // if it were never used. However, accessing this property would be faster.
91 if (null == event_handlers)
92 event_handlers = new EventHandlerList();
94 return event_handlers;
103 public void Dispose ()
106 GC.SuppressFinalize (this);
110 // Controls disposal of resources used by this.
113 // <param name="release_all"> Controls which resources are released</param>
116 // if release_all is set to true, both managed and unmanaged
117 // resources should be released. If release_all is set to false,
118 // only unmanaged resources should be disposed
120 protected virtual void Dispose (bool release_all)
123 if (mySite != null && mySite.Container != null)
124 mySite.Container.Remove (this);
125 EventHandler eh = (EventHandler) Events [disposedEvent];
127 eh (this, EventArgs.Empty);
131 protected virtual object GetService (Type service)
133 if (mySite != null) {
134 return mySite.GetService(service);
139 public override string ToString ()
142 return GetType ().ToString ();
143 return String.Format ("{0} [{1}]", mySite.Name, GetType ().ToString ());
146 [Browsable (false), EditorBrowsable (EditorBrowsableState.Advanced)]
147 public event EventHandler Disposed {
148 add { Events.AddHandler (disposedEvent, value); }
149 remove { Events.RemoveHandler (disposedEvent, value); }