class/System/System.ComponentModel/TypeConverter.cs

   1 //
   2 // System.ComponentModel.TypeConverter.cs
   3 //
   4 // Authors:
   5 //   Gonzalo Paniagua Javier (gonzalo@ximian.com)
   6 //   Andreas Nahr (ClassDevelopment@A-SoftTech.com)
   7 //
   8 // (C) 2002/2003 Ximian, Inc (http://www.ximian.com)
   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.Collections;
  35 using System.ComponentModel.Design.Serialization;
  36 using System.Globalization;
  37 using System.Runtime.InteropServices;
  38
  39 namespace System.ComponentModel
  40 {
  41         [ComVisible (true)]
  42         public class TypeConverter
  43         {
  44                 public bool CanConvertFrom (Type sourceType)
  45                 {
  46                         return CanConvertFrom (null, sourceType);
  47                 }
  48
  49                 public virtual bool CanConvertFrom (ITypeDescriptorContext context, Type sourceType)
  50                 {
  51                         if (sourceType == typeof (InstanceDescriptor)) {
  52                                 return true;
  53                         }
  54
  55                         return false;
  56                 }
  57
  58                 public bool CanConvertTo (Type destinationType)
  59                 {
  60                         return CanConvertTo (null, destinationType);
  61                 }
  62
  63                 public virtual bool CanConvertTo (ITypeDescriptorContext context, Type destinationType)
  64                 {
  65                         return (destinationType == typeof (string));
  66                 }
  67
  68                 public object ConvertFrom (object o)
  69                 {
  70                         return ConvertFrom (null, CultureInfo.CurrentCulture, o);
  71                 }
  72
  73                 public virtual object ConvertFrom (ITypeDescriptorContext context, CultureInfo culture, object value)
  74                 {
  75                         if (value is InstanceDescriptor) {
  76                                 return ((InstanceDescriptor) value).Invoke ();
  77                         }
  78
  79                         return GetConvertFromException (value);
  80                 }
  81
  82                 public object ConvertFromInvariantString (string text)
  83                 {
  84                         return ConvertFromInvariantString (null, text);
  85                 }
  86
  87                 public object ConvertFromInvariantString (ITypeDescriptorContext context, string text)
  88                 {
  89                         return ConvertFromString (context, CultureInfo.InvariantCulture, text);
  90                 }
  91
  92                 public object ConvertFromString (string text)
  93                 {
  94                         return ConvertFrom (text);
  95                 }
  96
  97                 public object ConvertFromString (ITypeDescriptorContext context, string text)
  98                 {
  99                         return ConvertFromString (context, CultureInfo.CurrentCulture, text);
 100                 }
 101
 102                 public object ConvertFromString (ITypeDescriptorContext context, CultureInfo culture, string text)
 103                 {
 104                         return ConvertFrom (context, culture, text);
 105                 }
 106
 107                 public object ConvertTo (object value, Type destinationType)
 108                 {
 109                         return ConvertTo (null, null, value, destinationType);
 110                 }
 111
 112                 public virtual object ConvertTo (ITypeDescriptorContext context, CultureInfo culture, object value,
 113                                                  Type destinationType)
 114                 {
 115                         // context? culture?
 116                         if (destinationType == null)
 117                                 throw new ArgumentNullException ("destinationType");
 118
 119                         if (destinationType == typeof (string)) {
 120                                 if (value != null)
 121                                         return value.ToString();
 122                                 return String.Empty;
 123                         }
 124
 125                         return GetConvertToException (value, destinationType);
 126                 }
 127
 128                 public string ConvertToInvariantString (object value)
 129                 {
 130                         return ConvertToInvariantString (null, value);
 131                 }
 132
 133                 public string ConvertToInvariantString (ITypeDescriptorContext context, object value)
 134                 {
 135                         return (string) ConvertTo (context, CultureInfo.InvariantCulture, value, typeof (string));
 136                 }
 137
 138                 public string ConvertToString (object value)
 139                 {
 140                         return (string) ConvertTo (null, CultureInfo.CurrentCulture, value, typeof (string));
 141                 }
 142
 143                 public string ConvertToString (ITypeDescriptorContext context, object value)
 144                 {
 145                         return (string) ConvertTo (context, CultureInfo.CurrentCulture, value, typeof (string));
 146                 }
 147
 148                 public string ConvertToString (ITypeDescriptorContext context, CultureInfo culture, object value)
 149                 {
 150                         return (string) ConvertTo (context, culture, value, typeof (string));
 151                 }
 152
 153                 protected Exception GetConvertFromException (object value)
 154                 {
 155                         string destinationType;
 156                         if (value == null)
 157                                 destinationType = "(null)";
 158                         else
 159                                 destinationType = value.GetType ().FullName;
 160
 161                         throw new NotSupportedException (string.Format (CultureInfo.InvariantCulture,
 162                                 "{0} cannot convert from {1}.", this.GetType ().Name,
 163                                 destinationType));
 164                 }
 165
 166                 protected Exception GetConvertToException (object value, Type destinationType)
 167                 {
 168                         string sourceType;
 169                         if (value == null)
 170                                 sourceType = "(null)";
 171                         else
 172                                 sourceType = value.GetType ().FullName;
 173
 174                         throw new NotSupportedException (string.Format (CultureInfo.InvariantCulture,
 175                                 "'{0}' is unable to convert '{1}' to '{2}'.", this.GetType ().Name,
 176                                 sourceType, destinationType.FullName));
 177                 }
 178
 179                 public object CreateInstance (IDictionary propertyValues)
 180                 {
 181                         return CreateInstance (null, propertyValues);
 182                 }
 183
 184                 public virtual object CreateInstance (ITypeDescriptorContext context, IDictionary propertyValues)
 185                 {
 186                         return null;
 187                 }
 188
 189                 public bool GetCreateInstanceSupported ()
 190                 {
 191                         return GetCreateInstanceSupported (null);
 192                 }
 193
 194                 public virtual bool GetCreateInstanceSupported (ITypeDescriptorContext context)
 195                 {
 196                         return false;
 197                 }
 198
 199                 public PropertyDescriptorCollection GetProperties (object value)
 200                 {
 201                         return GetProperties (null, value);
 202                 }
 203
 204                 public PropertyDescriptorCollection GetProperties (ITypeDescriptorContext context, object value)
 205                 {
 206                         return GetProperties (context, value, new Attribute[1] { BrowsableAttribute.Yes });
 207                 }
 208
 209                 public virtual PropertyDescriptorCollection GetProperties (ITypeDescriptorContext context,
 210                                                                            object value, Attribute[] attributes)
 211                 {
 212                         return null;
 213                 }
 214
 215                 public bool GetPropertiesSupported ()
 216                 {
 217                         return GetPropertiesSupported (null);
 218                 }
 219
 220                 public virtual bool GetPropertiesSupported (ITypeDescriptorContext context)
 221                 {
 222                         return false;
 223                 }
 224
 225                 public ICollection GetStandardValues ()
 226                 {
 227                         return GetStandardValues (null);
 228                 }
 229
 230                 public virtual StandardValuesCollection GetStandardValues (ITypeDescriptorContext context)
 231                 {
 232                         return null;
 233                 }
 234
 235                 public bool GetStandardValuesExclusive ()
 236                 {
 237                         return GetStandardValuesExclusive (null);
 238                 }
 239
 240                 public virtual bool GetStandardValuesExclusive (ITypeDescriptorContext context)
 241                 {
 242                         return false;
 243                 }
 244
 245                 public bool GetStandardValuesSupported ()
 246                 {
 247                         return GetStandardValuesSupported (null);
 248                 }
 249
 250                 public virtual bool GetStandardValuesSupported (ITypeDescriptorContext context)
 251                 {
 252                         return false;
 253                 }
 254
 255                 public bool IsValid (object value)
 256                 {
 257                         return IsValid (null, value);
 258                 }
 259
 260                 public virtual bool IsValid (ITypeDescriptorContext context, object value)
 261                 {
 262                         return true;
 263                 }
 264
 265                 protected PropertyDescriptorCollection SortProperties (PropertyDescriptorCollection props, string[] names)
 266                 {
 267                         props.Sort (names);
 268                         return props;
 269                 }
 270
 271                 public class StandardValuesCollection : ICollection, IEnumerable
 272                 {
 273                         private ICollection values;
 274
 275                         public StandardValuesCollection (ICollection values)
 276                         {
 277                                 this.values = values;
 278                         }
 279
 280                         void ICollection.CopyTo (Array array, int index) {
 281                                 CopyTo (array, index);
 282                         }
 283
 284                         public void CopyTo (Array array, int index)
 285                         {
 286                                 values.CopyTo (array, index);
 287                         }
 288
 289                         IEnumerator IEnumerable.GetEnumerator () {
 290                                 return GetEnumerator ();
 291                         }
 292
 293                         public IEnumerator GetEnumerator ()
 294                         {
 295                                 return values.GetEnumerator ();
 296                         }
 297
 298                         bool ICollection.IsSynchronized {
 299                                 get { return false; }
 300                         }
 301
 302                         object ICollection.SyncRoot {
 303                                 get { return null; }
 304                         }
 305
 306                         int ICollection.Count {
 307                                 get { return this.Count; }
 308                         }
 309
 310                         public int Count {
 311                                 get { return values.Count; }
 312                         }
 313
 314                         public object this [int index] {
 315                                 get { return ((IList) values) [index]; }
 316                         }
 317                 }
 318
 319                 protected abstract class SimplePropertyDescriptor : PropertyDescriptor
 320                 {
 321                         private Type componentType;
 322                         private Type propertyType;
 323
 324                         public SimplePropertyDescriptor (Type componentType,
 325                                                          string name,
 326                                                          Type propertyType) :
 327                                 this (componentType, name, propertyType, null)
 328                         {
 329                         }
 330
 331                         public SimplePropertyDescriptor (Type componentType,
 332                                                          string name,
 333                                                          Type propertyType,
 334                                                          Attribute [] attributes) : base (name, attributes)
 335                         {
 336                                 this.componentType = componentType;
 337                                 this.propertyType = propertyType;
 338                         }
 339
 340                         public override Type ComponentType {
 341                                 get { return componentType; }
 342                         }
 343
 344                         public override Type PropertyType {
 345                                 get { return propertyType; }
 346                         }
 347
 348                         public override bool IsReadOnly {
 349                                 get { return Attributes.Contains (ReadOnlyAttribute.Yes); }
 350                         }
 351
 352                         public override bool ShouldSerializeValue (object component)
 353                         {
 354                                         return false;
 355                         }
 356
 357                         public override bool CanResetValue (object component)
 358                         {
 359                                 DefaultValueAttribute Attrib = ((DefaultValueAttribute) Attributes[typeof (DefaultValueAttribute)]);
 360                                 if (Attrib == null) {
 361                                         return false;
 362                                 }
 363                                 return (Attrib.Value == GetValue (component));
 364                         }
 365
 366                         public override void ResetValue (object component)
 367                         {
 368                                 DefaultValueAttribute Attrib = ((DefaultValueAttribute) Attributes[typeof (DefaultValueAttribute)]);
 369                                 if (Attrib != null) {
 370                                         SetValue (component, Attrib.Value);
 371                                 }
 372
 373                         }
 374                 }
 375         }
 376 }
 377