Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / CompMod / System / ComponentModel / TypeDescriptionProvider.cs / 1305376 / TypeDescriptionProvider.cs
//------------------------------------------------------------------------------ //// Copyright (c) Microsoft Corporation. All rights reserved. // //----------------------------------------------------------------------------- namespace System.ComponentModel { using System; using System.Collections; using System.Reflection; using System.Security.Permissions; ////// The TypeDescriptionProvider class can be thought of as a "plug-in" for /// TypeDescriptor. There can be multiple type description provider classes /// all offering metadata to TypeDescriptor /// [HostProtection(SharedState = true)] public abstract class TypeDescriptionProvider { private TypeDescriptionProvider _parent; private EmptyCustomTypeDescriptor _emptyDescriptor; ////// There are two versions of the constructor for this class. The empty /// constructor is identical to using TypeDescriptionProvider(null). /// If a child type description provider is passed into the constructor, /// the "base" versions of all methods will call to this parent provider. /// If no such provider is given, the base versions of the methods will /// return empty, but valid values. /// protected TypeDescriptionProvider() { } ////// There are two versions of the constructor for this class. The empty /// constructor is identical to using TypeDescriptionProvider(null). /// If a child type description provider is passed into the constructor, /// the "base" versions of all methods will call to this parent provider. /// If no such provider is given, the base versions of the methods will /// return empty, but valid values. /// protected TypeDescriptionProvider(TypeDescriptionProvider parent) { _parent = parent; } ////// This method is used to create an instance that can substitute for another /// data type. If the method is not interested in providing a substitute /// instance, it should call base. /// /// This method is prototyped as virtual, and by default returns null if no /// parent provider was passed. If a parent provider was passed, this /// method will invoke the parent provider's CreateInstance method. /// public virtual object CreateInstance(IServiceProvider provider, Type objectType, Type[] argTypes, object[] args) { if (_parent != null) { return _parent.CreateInstance(provider, objectType, argTypes, args); } if (objectType == null) { throw new ArgumentNullException("objectType"); } return SecurityUtils.SecureCreateInstance(objectType, args); } ////// TypeDescriptor may need to perform complex operations on collections of metadata. /// Since types are not unloaded for the life of a domain, TypeDescriptor will /// automatically cache the results of these operations based on type. There are a /// number of operations that use live object instances, however. These operations /// cannot be cached within TypeDescriptor because caching them would prevent the /// object from garbage collecting. Instead, TypeDescriptor allows for a per-object /// cache, accessed as an IDictionary of key/value pairs, to exist on an object. /// The GetCache method returns an instance of this cache. GetCache will return /// null if there is no supported cache for an object. /// public virtual IDictionary GetCache(object instance) { if (_parent != null) { return _parent.GetCache(instance); } return null; } ////// This method returns an extended custom type descriptor for the given object. /// An extended type descriptor is a custom type descriptor that offers properties /// that other objects have added to this object, but are not actually defined on /// the object. For example, in the .NET Framework Component Model, objects that /// implement the interface IExtenderProvider can "attach" properties to other /// objects that reside in the same logical container. The GetTypeDescriptor /// method does not return a type descriptor that provides these extra extended /// properties. GetExtendedTypeDescriptor returns the set of these extended /// properties. TypeDescriptor will automatically merge the results of these /// two property collections. Note that while the .NET Framework component /// model only supports extended properties this API can be used for extended /// attributes and events as well, if the type description provider supports it. /// public virtual ICustomTypeDescriptor GetExtendedTypeDescriptor(object instance) { if (_parent != null) { return _parent.GetExtendedTypeDescriptor(instance); } if (_emptyDescriptor == null) { _emptyDescriptor = new EmptyCustomTypeDescriptor(); } return _emptyDescriptor; } protected internal virtual IExtenderProvider[] GetExtenderProviders(object instance) { if (_parent != null) { return _parent.GetExtenderProviders(instance); } if (instance == null) { throw new ArgumentNullException("instance"); } return new IExtenderProvider[0]; } ////// The name of the specified component, or null if the component has no name. /// In many cases this will return the same value as GetComponentName. If the /// component resides in a nested container or has other nested semantics, it may /// return a different fully qualfied name. /// /// If not overridden, the default implementation of this method will call /// GetTypeDescriptor.GetComponentName. /// public virtual string GetFullComponentName(object component) { if (_parent != null) { return _parent.GetFullComponentName(component); } return GetTypeDescriptor(component).GetComponentName(); } ////// The GetReflection method is a lower level version of GetTypeDescriptor. /// If no custom type descriptor can be located for an object, GetReflectionType /// is called to perform normal reflection against the object. /// public Type GetReflectionType(Type objectType) { return GetReflectionType(objectType, null); } ////// The GetReflection method is a lower level version of GetTypeDescriptor. /// If no custom type descriptor can be located for an object, GetReflectionType /// is called to perform normal reflection against the object. /// /// This method is prototyped as virtual, and by default returns the /// object type if no parent provider was passed. If a parent provider was passed, this /// method will invoke the parent provider's GetReflectionType method. /// public Type GetReflectionType(object instance) { if (instance == null) { throw new ArgumentNullException("instance"); } return GetReflectionType(instance.GetType(), instance); } ////// The GetReflection method is a lower level version of GetTypeDescriptor. /// If no custom type descriptor can be located for an object, GetReflectionType /// is called to perform normal reflection against the object. /// /// This method is prototyped as virtual, and by default returns the /// object type if no parent provider was passed. If a parent provider was passed, this /// method will invoke the parent provider's GetReflectionType method. /// public virtual Type GetReflectionType(Type objectType, object instance) { if (_parent != null) { return _parent.GetReflectionType(objectType, instance); } return objectType; } ////// The GetRuntimeType method reverses GetReflectionType to convert a reflection type /// back into a runtime type. Historically the Type.UnderlyingSystemType property has /// been used to return the runtime type. This isn't exactly correct, but it needs /// to be preserved unless all type description providers are revised. /// public virtual Type GetRuntimeType(Type reflectionType) { if (_parent != null) { return _parent.GetRuntimeType(reflectionType); } if (reflectionType == null) { throw new ArgumentNullException("reflectionType"); } if (reflectionType.GetType().Assembly == typeof(object).Assembly) { return reflectionType; } return reflectionType.UnderlyingSystemType; } ////// This method returns a custom type descriptor for the given type / object. /// The objectType parameter is always valid, but the instance parameter may /// be null if no instance was passed to TypeDescriptor. The method should /// return a custom type descriptor for the object. If the method is not /// interested in providing type information for the object it should /// return base. /// public ICustomTypeDescriptor GetTypeDescriptor(Type objectType) { return GetTypeDescriptor(objectType, null); } ////// This method returns a custom type descriptor for the given type / object. /// The objectType parameter is always valid, but the instance parameter may /// be null if no instance was passed to TypeDescriptor. The method should /// return a custom type descriptor for the object. If the method is not /// interested in providing type information for the object it should /// return base. /// public ICustomTypeDescriptor GetTypeDescriptor(object instance) { if (instance == null) { throw new ArgumentNullException("instance"); } return GetTypeDescriptor(instance.GetType(), instance); } ////// This method returns a custom type descriptor for the given type / object. /// The objectType parameter is always valid, but the instance parameter may /// be null if no instance was passed to TypeDescriptor. The method should /// return a custom type descriptor for the object. If the method is not /// interested in providing type information for the object it should /// return base. /// /// This method is prototyped as virtual, and by default returns a /// custom type descriptor that returns empty collections for all values /// if no parent provider was passed. If a parent provider was passed, /// this method will invoke the parent provider's GetTypeDescriptor /// method. /// public virtual ICustomTypeDescriptor GetTypeDescriptor(Type objectType, object instance) { if (_parent != null) { return _parent.GetTypeDescriptor(objectType, instance); } if (_emptyDescriptor == null) { _emptyDescriptor = new EmptyCustomTypeDescriptor(); } return _emptyDescriptor; } ////// This method returns true if the type is "supported" by the type descriptor /// and its chain of type description providers. /// public virtual bool IsSupportedType(Type type) { if (type == null) { throw new ArgumentNullException("type"); } if (_parent != null) { return _parent.IsSupportedType(type); } return true; } ////// A simple empty descriptor that is used as a placeholder for times /// when the user does not provide their own. /// private sealed class EmptyCustomTypeDescriptor : CustomTypeDescriptor { } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. //------------------------------------------------------------------------------ //// Copyright (c) Microsoft Corporation. All rights reserved. // //----------------------------------------------------------------------------- namespace System.ComponentModel { using System; using System.Collections; using System.Reflection; using System.Security.Permissions; ////// The TypeDescriptionProvider class can be thought of as a "plug-in" for /// TypeDescriptor. There can be multiple type description provider classes /// all offering metadata to TypeDescriptor /// [HostProtection(SharedState = true)] public abstract class TypeDescriptionProvider { private TypeDescriptionProvider _parent; private EmptyCustomTypeDescriptor _emptyDescriptor; ////// There are two versions of the constructor for this class. The empty /// constructor is identical to using TypeDescriptionProvider(null). /// If a child type description provider is passed into the constructor, /// the "base" versions of all methods will call to this parent provider. /// If no such provider is given, the base versions of the methods will /// return empty, but valid values. /// protected TypeDescriptionProvider() { } ////// There are two versions of the constructor for this class. The empty /// constructor is identical to using TypeDescriptionProvider(null). /// If a child type description provider is passed into the constructor, /// the "base" versions of all methods will call to this parent provider. /// If no such provider is given, the base versions of the methods will /// return empty, but valid values. /// protected TypeDescriptionProvider(TypeDescriptionProvider parent) { _parent = parent; } ////// This method is used to create an instance that can substitute for another /// data type. If the method is not interested in providing a substitute /// instance, it should call base. /// /// This method is prototyped as virtual, and by default returns null if no /// parent provider was passed. If a parent provider was passed, this /// method will invoke the parent provider's CreateInstance method. /// public virtual object CreateInstance(IServiceProvider provider, Type objectType, Type[] argTypes, object[] args) { if (_parent != null) { return _parent.CreateInstance(provider, objectType, argTypes, args); } if (objectType == null) { throw new ArgumentNullException("objectType"); } return SecurityUtils.SecureCreateInstance(objectType, args); } ////// TypeDescriptor may need to perform complex operations on collections of metadata. /// Since types are not unloaded for the life of a domain, TypeDescriptor will /// automatically cache the results of these operations based on type. There are a /// number of operations that use live object instances, however. These operations /// cannot be cached within TypeDescriptor because caching them would prevent the /// object from garbage collecting. Instead, TypeDescriptor allows for a per-object /// cache, accessed as an IDictionary of key/value pairs, to exist on an object. /// The GetCache method returns an instance of this cache. GetCache will return /// null if there is no supported cache for an object. /// public virtual IDictionary GetCache(object instance) { if (_parent != null) { return _parent.GetCache(instance); } return null; } ////// This method returns an extended custom type descriptor for the given object. /// An extended type descriptor is a custom type descriptor that offers properties /// that other objects have added to this object, but are not actually defined on /// the object. For example, in the .NET Framework Component Model, objects that /// implement the interface IExtenderProvider can "attach" properties to other /// objects that reside in the same logical container. The GetTypeDescriptor /// method does not return a type descriptor that provides these extra extended /// properties. GetExtendedTypeDescriptor returns the set of these extended /// properties. TypeDescriptor will automatically merge the results of these /// two property collections. Note that while the .NET Framework component /// model only supports extended properties this API can be used for extended /// attributes and events as well, if the type description provider supports it. /// public virtual ICustomTypeDescriptor GetExtendedTypeDescriptor(object instance) { if (_parent != null) { return _parent.GetExtendedTypeDescriptor(instance); } if (_emptyDescriptor == null) { _emptyDescriptor = new EmptyCustomTypeDescriptor(); } return _emptyDescriptor; } protected internal virtual IExtenderProvider[] GetExtenderProviders(object instance) { if (_parent != null) { return _parent.GetExtenderProviders(instance); } if (instance == null) { throw new ArgumentNullException("instance"); } return new IExtenderProvider[0]; } ////// The name of the specified component, or null if the component has no name. /// In many cases this will return the same value as GetComponentName. If the /// component resides in a nested container or has other nested semantics, it may /// return a different fully qualfied name. /// /// If not overridden, the default implementation of this method will call /// GetTypeDescriptor.GetComponentName. /// public virtual string GetFullComponentName(object component) { if (_parent != null) { return _parent.GetFullComponentName(component); } return GetTypeDescriptor(component).GetComponentName(); } ////// The GetReflection method is a lower level version of GetTypeDescriptor. /// If no custom type descriptor can be located for an object, GetReflectionType /// is called to perform normal reflection against the object. /// public Type GetReflectionType(Type objectType) { return GetReflectionType(objectType, null); } ////// The GetReflection method is a lower level version of GetTypeDescriptor. /// If no custom type descriptor can be located for an object, GetReflectionType /// is called to perform normal reflection against the object. /// /// This method is prototyped as virtual, and by default returns the /// object type if no parent provider was passed. If a parent provider was passed, this /// method will invoke the parent provider's GetReflectionType method. /// public Type GetReflectionType(object instance) { if (instance == null) { throw new ArgumentNullException("instance"); } return GetReflectionType(instance.GetType(), instance); } ////// The GetReflection method is a lower level version of GetTypeDescriptor. /// If no custom type descriptor can be located for an object, GetReflectionType /// is called to perform normal reflection against the object. /// /// This method is prototyped as virtual, and by default returns the /// object type if no parent provider was passed. If a parent provider was passed, this /// method will invoke the parent provider's GetReflectionType method. /// public virtual Type GetReflectionType(Type objectType, object instance) { if (_parent != null) { return _parent.GetReflectionType(objectType, instance); } return objectType; } ////// The GetRuntimeType method reverses GetReflectionType to convert a reflection type /// back into a runtime type. Historically the Type.UnderlyingSystemType property has /// been used to return the runtime type. This isn't exactly correct, but it needs /// to be preserved unless all type description providers are revised. /// public virtual Type GetRuntimeType(Type reflectionType) { if (_parent != null) { return _parent.GetRuntimeType(reflectionType); } if (reflectionType == null) { throw new ArgumentNullException("reflectionType"); } if (reflectionType.GetType().Assembly == typeof(object).Assembly) { return reflectionType; } return reflectionType.UnderlyingSystemType; } ////// This method returns a custom type descriptor for the given type / object. /// The objectType parameter is always valid, but the instance parameter may /// be null if no instance was passed to TypeDescriptor. The method should /// return a custom type descriptor for the object. If the method is not /// interested in providing type information for the object it should /// return base. /// public ICustomTypeDescriptor GetTypeDescriptor(Type objectType) { return GetTypeDescriptor(objectType, null); } ////// This method returns a custom type descriptor for the given type / object. /// The objectType parameter is always valid, but the instance parameter may /// be null if no instance was passed to TypeDescriptor. The method should /// return a custom type descriptor for the object. If the method is not /// interested in providing type information for the object it should /// return base. /// public ICustomTypeDescriptor GetTypeDescriptor(object instance) { if (instance == null) { throw new ArgumentNullException("instance"); } return GetTypeDescriptor(instance.GetType(), instance); } ////// This method returns a custom type descriptor for the given type / object. /// The objectType parameter is always valid, but the instance parameter may /// be null if no instance was passed to TypeDescriptor. The method should /// return a custom type descriptor for the object. If the method is not /// interested in providing type information for the object it should /// return base. /// /// This method is prototyped as virtual, and by default returns a /// custom type descriptor that returns empty collections for all values /// if no parent provider was passed. If a parent provider was passed, /// this method will invoke the parent provider's GetTypeDescriptor /// method. /// public virtual ICustomTypeDescriptor GetTypeDescriptor(Type objectType, object instance) { if (_parent != null) { return _parent.GetTypeDescriptor(objectType, instance); } if (_emptyDescriptor == null) { _emptyDescriptor = new EmptyCustomTypeDescriptor(); } return _emptyDescriptor; } ////// This method returns true if the type is "supported" by the type descriptor /// and its chain of type description providers. /// public virtual bool IsSupportedType(Type type) { if (type == null) { throw new ArgumentNullException("type"); } if (_parent != null) { return _parent.IsSupportedType(type); } return true; } ////// A simple empty descriptor that is used as a placeholder for times /// when the user does not provide their own. /// private sealed class EmptyCustomTypeDescriptor : CustomTypeDescriptor { } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- ErrorFormatter.cs
- ContentDisposition.cs
- StreamResourceInfo.cs
- RijndaelManagedTransform.cs
- XamlBrushSerializer.cs
- SQLBoolean.cs
- StringExpressionSet.cs
- AppDomainManager.cs
- ServiceProviders.cs
- ImagingCache.cs
- EntityDataSourceChangedEventArgs.cs
- XmlCharCheckingWriter.cs
- Hex.cs
- ItemMap.cs
- GridSplitter.cs
- VarRefManager.cs
- CompilerParameters.cs
- Rotation3D.cs
- XmlRawWriterWrapper.cs
- SrgsToken.cs
- EncodedStreamFactory.cs
- PkcsUtils.cs
- GridViewEditEventArgs.cs
- MetaType.cs
- BitmapEffectGeneralTransform.cs
- HttpModuleActionCollection.cs
- WindowsListViewItem.cs
- TransformerInfoCollection.cs
- SamlConditions.cs
- IResourceProvider.cs
- RewritingSimplifier.cs
- SessionSymmetricMessageSecurityProtocolFactory.cs
- WebPartConnectionsEventArgs.cs
- configsystem.cs
- SiteMapNodeItemEventArgs.cs
- XmlResolver.cs
- HashSet.cs
- PageEventArgs.cs
- DesignerActionListCollection.cs
- MetaData.cs
- COAUTHIDENTITY.cs
- ProvideValueServiceProvider.cs
- InfoCardArgumentException.cs
- TextEffect.cs
- ConnectivityStatus.cs
- FileDialogCustomPlacesCollection.cs
- ScriptingProfileServiceSection.cs
- WorkerRequest.cs
- PortCache.cs
- XPathExpr.cs
- FixedSOMElement.cs
- QuotaThrottle.cs
- TransportSecurityHelpers.cs
- FormatException.cs
- AdPostCacheSubstitution.cs
- BinarySerializer.cs
- XmlHierarchicalEnumerable.cs
- ExceptionHelpers.cs
- InstanceHandleConflictException.cs
- NamespaceList.cs
- MouseWheelEventArgs.cs
- CellNormalizer.cs
- InternalDuplexChannelFactory.cs
- storepermissionattribute.cs
- FileSystemInfo.cs
- DeploymentSection.cs
- Classification.cs
- DataView.cs
- TextContainer.cs
- ColorKeyFrameCollection.cs
- NetPeerTcpBindingCollectionElement.cs
- CmsInterop.cs
- DataColumnCollection.cs
- FloaterBaseParaClient.cs
- DynamicMethod.cs
- HtmlTextArea.cs
- CharAnimationUsingKeyFrames.cs
- XPathNodeIterator.cs
- HttpDictionary.cs
- DbFunctionCommandTree.cs
- MessageEventSubscriptionService.cs
- SiteOfOriginContainer.cs
- FlowDocumentPage.cs
- MDIWindowDialog.cs
- UInt16.cs
- QilValidationVisitor.cs
- ChannelReliableSession.cs
- EntityDataSourceEntityTypeFilterItem.cs
- nulltextcontainer.cs
- MethodRental.cs
- HandlerFactoryWrapper.cs
- ClientRuntimeConfig.cs
- _Win32.cs
- Compress.cs
- TableProviderWrapper.cs
- RotateTransform3D.cs
- TextDecorationCollectionConverter.cs
- HttpCacheParams.cs
- StorageConditionPropertyMapping.cs
- StrokeCollectionConverter.cs