Code:
/ 4.0 / 4.0 / untmp / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / DataWeb / Server / System / Data / Services / Providers / ResourceProperty.cs / 1305376 / ResourceProperty.cs
//---------------------------------------------------------------------- //// Copyright (c) Microsoft Corporation. All rights reserved. // //// Provides a type to describe properties on resources. // // // @owner [....] //--------------------------------------------------------------------- namespace System.Data.Services.Providers { using System; using System.Diagnostics; using System.Linq; using System.Reflection; ///Use this class to describe a property on a resource. [DebuggerDisplay("{kind}: {name}")] public class ResourceProperty { #region Private fields. ///The name of this property. private readonly string name; ///The kind of resource Type that this property refers to. /// For e.g. for collection properties, this would return the resource type, /// and not the collection type that this property refers to. private readonly ResourceType propertyResourceType; ///The kind of property this is in relation to the resource. private ResourcePropertyKind kind; ///Is true, if this property is a actual clr property on the property type. In this case, /// astoria service will do reflection over the property type and get/set value for this property. /// False means that astoria service needs to go through the IDataServiceQueryProvider contract to get/set value for this provider. private bool canReflectOnInstanceTypeProperty; ///Is true, if the resource property is set to readonly i.e. fully initialized and validated. No more changes can be made, /// once the resource property is set to readonly. private bool isReadOnly; ///MIME type for the property, if it's a primitive value. private string mimeType; #endregion Private fields. ////// Initializes a new ResourceProperty instance for an open property. /// /// Property name for the property. /// Property kind. /// The type of the resource that this property refers to public ResourceProperty( string name, ResourcePropertyKind kind, ResourceType propertyResourceType) { WebUtil.CheckStringArgumentNull(name, "name"); WebUtil.CheckArgumentNull(propertyResourceType, "propertyResourceType"); ValidatePropertyParameters(kind, propertyResourceType); this.kind = kind; this.name = name; this.propertyResourceType = propertyResourceType; this.canReflectOnInstanceTypeProperty = true; } #region Properties ///Indicates whether this property can be accessed through reflection on the declaring resource instance type. ///A 'true' value here typically indicates astoria service will use reflection to get the property info on the declaring ResourceType.InstanceType. /// 'false' means that astoria service will go through IDataServiceQueryProvider interface to get/set this property's value. public bool CanReflectOnInstanceTypeProperty { get { return this.canReflectOnInstanceTypeProperty; } set { this.ThrowIfSealed(); this.canReflectOnInstanceTypeProperty = value; } } ////// The resource type that is property refers to [For collection, /// this will return the element of the collection, and not the /// collection]. /// public ResourceType ResourceType { [DebuggerStepThrough] get { return this.propertyResourceType; } } ///The property name. public string Name { [DebuggerStepThrough] get { return this.name; } } ///MIME type for the property, if it's a primitive value; null if none specified. public string MimeType { [DebuggerStepThrough] get { return this.mimeType; } set { this.ThrowIfSealed(); if (String.IsNullOrEmpty(value)) { throw new InvalidOperationException(Strings.ResourceProperty_MimeTypeAttributeEmpty(this.Name)); } if (this.ResourceType.ResourceTypeKind != ResourceTypeKind.Primitive) { throw new InvalidOperationException(Strings.ResourceProperty_MimeTypeAttributeOnNonPrimitive(this.Name, this.ResourceType.FullName)); } if (!WebUtil.IsValidMimeType(value)) { throw new InvalidOperationException(Strings.ResourceProperty_MimeTypeNotValid(value, this.Name)); } this.mimeType = value; } } ///The kind of property this is in relation to the resource. public ResourcePropertyKind Kind { [DebuggerStepThrough] get { return this.kind; } [DebuggerStepThrough] internal set { Debug.Assert(!this.isReadOnly, "Kind - the resource property cannot be readonly"); this.kind = value; } } ////// PlaceHolder to hold custom state information about resource property. /// public object CustomState { get; set; } ////// Returns true, if this resource property has been set to read only. Otherwise returns false. /// public bool IsReadOnly { get { return this.isReadOnly; } } ///The kind of type this property has in relation to the data service. internal ResourceTypeKind TypeKind { get { return this.ResourceType.ResourceTypeKind; } } ///The type of the property. internal Type Type { get { if (this.Kind == ResourcePropertyKind.ResourceSetReference) { return typeof(System.Collections.Generic.IEnumerable<>).MakeGenericType(this.propertyResourceType.InstanceType); } else { return this.propertyResourceType.InstanceType; } } } #endregion Properties #region Methods ////// Sets the resource property to readonly. Once this method is called, no more changes can be made to resource property. /// public void SetReadOnly() { // If its already set to readonly, do no-op if (this.isReadOnly) { return; } this.ResourceType.SetReadOnly(); this.isReadOnly = true; } ////// return true if this property is of the given kind /// /// flag which needs to be checked on the current property kind ///true if the current property is of the given kind internal bool IsOfKind(ResourcePropertyKind checkKind) { return ResourceProperty.IsOfKind(this.kind, checkKind); } ////// return true if the given property kind is of the given kind /// /// kind of the property /// flag which needs to be checked on property kind ///true if the kind flag is set on the given property kind private static bool IsOfKind(ResourcePropertyKind propertyKind, ResourcePropertyKind kind) { return ((propertyKind & kind) == kind); } ////// Validates that the given property kind is valid /// /// property kind to check /// name of the parameter private static void CheckResourcePropertyKind(ResourcePropertyKind kind, string parameterName) { // For open properties, resource property instance is created only for nav properties. if (kind != ResourcePropertyKind.ResourceReference && kind != ResourcePropertyKind.ResourceSetReference && kind != ResourcePropertyKind.ComplexType && kind != ResourcePropertyKind.Primitive && kind != (ResourcePropertyKind.Primitive | ResourcePropertyKind.Key) && kind != (ResourcePropertyKind.Primitive | ResourcePropertyKind.ETag)) { throw new ArgumentException(Strings.InvalidEnumValue(kind.GetType().Name), parameterName); } } ////// Validate the parameters of the resource property constructor. /// /// kind of the resource property. /// resource type that this property refers to. private static void ValidatePropertyParameters(ResourcePropertyKind kind, ResourceType propertyResourceType) { CheckResourcePropertyKind(kind, "kind"); if (IsOfKind(kind, ResourcePropertyKind.ResourceReference) || IsOfKind(kind, ResourcePropertyKind.ResourceSetReference)) { if (propertyResourceType.ResourceTypeKind != ResourceTypeKind.EntityType) { throw new ArgumentException(Strings.ResourceProperty_PropertyKindAndResourceTypeKindMismatch("kind", "propertyResourceType")); } } if (IsOfKind(kind, ResourcePropertyKind.Primitive)) { if (propertyResourceType.ResourceTypeKind != ResourceTypeKind.Primitive) { throw new ArgumentException(Strings.ResourceProperty_PropertyKindAndResourceTypeKindMismatch("kind", "propertyResourceType")); } } if (IsOfKind(kind, ResourcePropertyKind.ComplexType)) { if (propertyResourceType.ResourceTypeKind != ResourceTypeKind.ComplexType) { throw new ArgumentException(Strings.ResourceProperty_PropertyKindAndResourceTypeKindMismatch("kind", "propertyResourceType")); } } if (IsOfKind(kind, ResourcePropertyKind.Key) && Nullable.GetUnderlyingType(propertyResourceType.InstanceType) != null) { throw new ArgumentException(Strings.ResourceProperty_KeyPropertiesCannotBeNullable); } } ////// Checks if the resource type is sealed. If not, it throws an InvalidOperationException. /// private void ThrowIfSealed() { if (this.isReadOnly) { throw new InvalidOperationException(Strings.ResourceProperty_Sealed(this.Name)); } } #endregion Methods } } // 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
- StyleSheetDesigner.cs
- ImageListUtils.cs
- ListViewInsertionMark.cs
- SelectorAutomationPeer.cs
- NamespaceCollection.cs
- NativeRightsManagementAPIsStructures.cs
- DeflateEmulationStream.cs
- ChangeBlockUndoRecord.cs
- StringFunctions.cs
- Point4D.cs
- ListItem.cs
- CodeDomLoader.cs
- TraceHandler.cs
- Condition.cs
- ContextConfiguration.cs
- ComponentChangedEvent.cs
- Baml6Assembly.cs
- UniqueConstraint.cs
- PopupRootAutomationPeer.cs
- ToolboxItemAttribute.cs
- SQLBinary.cs
- BrushMappingModeValidation.cs
- GridViewUpdateEventArgs.cs
- DataSourceXmlTextReader.cs
- CompiledRegexRunner.cs
- DateBoldEvent.cs
- ConfigurationException.cs
- XamlFrame.cs
- WmlFormAdapter.cs
- SqlException.cs
- DataGridAutoFormatDialog.cs
- SqlDataSourceCommandEventArgs.cs
- X509InitiatorCertificateServiceElement.cs
- Dynamic.cs
- XmlNodeChangedEventManager.cs
- RelationshipEndCollection.cs
- RegexParser.cs
- TypeDependencyAttribute.cs
- HandlerBase.cs
- SchemaAttDef.cs
- Win32Native.cs
- WSSecurityOneDotOneSendSecurityHeader.cs
- CollectionBuilder.cs
- SelectionProcessor.cs
- SessionStateContainer.cs
- FormParameter.cs
- ColumnResizeAdorner.cs
- SQlBooleanStorage.cs
- ITextView.cs
- BinaryQueryOperator.cs
- AQNBuilder.cs
- MeshGeometry3D.cs
- SmtpNtlmAuthenticationModule.cs
- EnumUnknown.cs
- MetadataProperty.cs
- QilStrConcat.cs
- EventLogInformation.cs
- X509ClientCertificateAuthenticationElement.cs
- SectionRecord.cs
- StatusBarItem.cs
- ZipIOZip64EndOfCentralDirectoryBlock.cs
- SQlBooleanStorage.cs
- WebScriptServiceHostFactory.cs
- EntityDesignerBuildProvider.cs
- PeerApplication.cs
- SamlAssertion.cs
- IssuedSecurityTokenProvider.cs
- ListViewGroup.cs
- StrongNameMembershipCondition.cs
- DynamicMethod.cs
- ObjectQuery.cs
- CultureMapper.cs
- WebColorConverter.cs
- DelegatedStream.cs
- DependencyPropertyChangedEventArgs.cs
- SpecialNameAttribute.cs
- SatelliteContractVersionAttribute.cs
- CommonDialog.cs
- InstanceNormalEvent.cs
- XPathMultyIterator.cs
- WebResourceAttribute.cs
- RuntimeIdentifierPropertyAttribute.cs
- ProcessManager.cs
- ValueTypeFieldReference.cs
- KeyValueConfigurationElement.cs
- ReflectionTypeLoadException.cs
- OutOfProcStateClientManager.cs
- Rect3DConverter.cs
- StringExpressionSet.cs
- PanelStyle.cs
- FlowDocumentReader.cs
- DbProviderFactory.cs
- WCFModelStrings.Designer.cs
- DbConnectionInternal.cs
- ListViewContainer.cs
- MultiBinding.cs
- PageThemeBuildProvider.cs
- ImageFormatConverter.cs
- NegotiateStream.cs
- CompoundFileIOPermission.cs