mcs/class/System/System.ComponentModel/MarshalByValueComponent.cs

   1 //
   2 // System.ComponentModel.MarshalByValueComponent.cs
   3 //
   4 // Author:
   5 //   Rodrigo Moya (rodrigo@ximian.com)
   6 //   Andreas Nahr (ClassDevelopment@A-SoftTech.com)
   7 //
   8 // (C) Ximian, Inc
   9 // (C) 2003 Andreas Nahr
  10 //
  11
  12 //
  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:
  20 //
  21 // The above copyright notice and this permission notice shall be
  22 // included in all copies or substantial portions of the Software.
  23 //
  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.
  31 //
  32
  33 using System;
  34 using System.ComponentModel;
  35 using System.ComponentModel.Design;
  36 using System.Runtime.InteropServices;
  37
  38 namespace System.ComponentModel
  39 {
  40         /// <summary>
  41         /// Implements IComponent and provides the base implementation for remotable components that are marshaled by value (a copy of the serialized object is passed).
  42         /// </summary>
  43         [DesignerCategory ("Component"), TypeConverter (typeof (ComponentConverter))]
  44         [Designer ("System.Windows.Forms.Design.ComponentDocumentDesigner, " + Consts.AssemblySystem_Design, typeof (IRootDesigner))]
  45 #if NET_2_0
  46         [ComVisible (true)]
  47 #endif
  48         public class MarshalByValueComponent : IComponent, IDisposable, IServiceProvider
  49         {
  50                 private EventHandlerList eventList;
  51                 private ISite mySite;
  52                 private object disposedEvent = new object ();
  53
  54                 public MarshalByValueComponent ()
  55                 {
  56                 }
  57
  58                 public void Dispose ()
  59                 {
  60                         Dispose (true);
  61                         GC.SuppressFinalize (this);
  62                 }
  63
  64                 [MonoTODO]
  65                 protected virtual void Dispose (bool disposing)
  66                 {
  67                         if (disposing) {
  68                                 // free managed objects contained here
  69                         }
  70
  71                         // Free unmanaged objects
  72                         // Set fields to null
  73                 }
  74
  75 #if !TARGET_JVM
  76                 ~MarshalByValueComponent ()
  77                 {
  78                         Dispose (false);
  79                 }
  80 #endif
  81
  82                 public virtual object GetService (Type service)
  83                 {
  84                         if (mySite != null) {
  85                                 return mySite.GetService(service);
  86                         }
  87                         return null;
  88                 }
  89
  90                 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
  91                 public virtual IContainer Container {
  92                         get {
  93                                 if (mySite == null)
  94                                         return null;
  95                                 return mySite.Container;
  96                         }
  97                 }
  98
  99                 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
 100                 public virtual bool DesignMode {
 101                         get {
 102                                 if (mySite == null)
 103                                         return false;
 104                                 return mySite.DesignMode;
 105                         }
 106                 }
 107
 108                 [Browsable (false), DesignerSerializationVisibility (DesignerSerializationVisibility.Hidden)]
 109                 public virtual ISite Site {
 110                         get { return mySite; }
 111                         set { mySite = value; }
 112                 }
 113
 114                 public override string ToString ()
 115                 {
 116                         if (mySite == null)
 117                                 return GetType ().ToString ();
 118                         return String.Format ("{0} [{1}]", mySite.Name, GetType ().ToString ());
 119                 }
 120
 121                 protected EventHandlerList Events {
 122                         get {
 123                                 if (eventList == null)
 124                                         eventList = new EventHandlerList ();
 125
 126                                 return eventList;
 127                         }
 128                 }
 129
 130                 public event EventHandler Disposed
 131                 {
 132                         add { Events.AddHandler (disposedEvent, value); }
 133                         remove { Events.RemoveHandler (disposedEvent, value); }
 134                 }
 135         }
 136 }
 137