Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / DataEntity / System / Data / Objects / ObjectStateEntry.cs / 1305376 / ObjectStateEntry.cs
//---------------------------------------------------------------------- //// Copyright (c) Microsoft Corporation. All rights reserved. // // // @owner [....] // @backupOwner [....] //--------------------------------------------------------------------- using System.Collections.Generic; using System.Data.Common; using System.Data.Metadata.Edm; using System.Data.Objects.DataClasses; using System.Diagnostics; using System.Collections; namespace System.Data.Objects { // Detached - nothing // Added - _entity & _currentValues only for shadowState // Unchanged - _entity & _currentValues only for shadowState // Unchanged -> Deleted - _entity & _currentValues only for shadowState // Modified - _currentValues & _modifiedFields + _originalValues only on change // Modified -> Deleted - _currentValues & _modifiedFields + _originalValues only on change ////// Represets either a entity, entity stub or relationship /// public abstract class ObjectStateEntry : IEntityStateEntry, IEntityChangeTracker { #region common entry fields internal ObjectStateManager _cache; internal EntitySetBase _entitySet; internal EntityState _state; #endregion #region Constructor // ObjectStateEntry will not be detached and creation will be handled from ObjectStateManager internal ObjectStateEntry(ObjectStateManager cache, EntitySet entitySet, EntityState state) { Debug.Assert(cache != null, "cache cannot be null."); _cache = cache; _entitySet = entitySet; _state = state; } #endregion // Constructor #region Public members ////// ObjectStateManager property of ObjectStateEntry. /// /// ///ObjectStateManager public ObjectStateManager ObjectStateManager { get { ValidateState(); return _cache; } } ///Extent property of ObjectStateEntry. /// ///Extent public EntitySetBase EntitySet { get { ValidateState(); return _entitySet; } } ////// State property of ObjectStateEntry. /// /// ///DataRowState public EntityState State { get { return _state; } internal set { _state = value; } } ////// Entity property of ObjectStateEntry. /// /// ///The entity encapsulated by this entry. abstract public object Entity { get; } ////// The EntityKey associated with the ObjectStateEntry /// abstract public EntityKey EntityKey { get; internal set; } ////// Determines if this ObjectStateEntry represents a relationship /// abstract public bool IsRelationship { get; } ////// Gets bit array indicating which properties are modified. /// abstract internal BitArray ModifiedProperties { get; } BitArray IEntityStateEntry.ModifiedProperties { get { return this.ModifiedProperties; } } ////// Original values of entity /// /// ///DbDataRecord [DebuggerBrowsable(DebuggerBrowsableState.Never)] // don't have debugger view expand this abstract public DbDataRecord OriginalValues { get; } abstract public OriginalValueRecord GetUpdatableOriginalValues(); ////// Current values of entity/ DataRow /// /// ///DbUpdatableDataRecord [DebuggerBrowsable(DebuggerBrowsableState.Never)] // don't have debugger view expand this abstract public CurrentValueRecord CurrentValues { get; } ////// API to accept the current values as original values and mark the entity as Unchanged. /// /// ///abstract public void AcceptChanges(); /// /// API to mark the entity deleted. if entity is in added state, it will be detached /// /// ///abstract public void Delete(); /// /// API to return properties that are marked modified /// /// ///IEnumerable of modified properties names, names are in term of c-space abstract public IEnumerableGetModifiedProperties(); /// /// set the state to Modified. /// /// ////// If State is not Modified or Unchanged /// abstract public void SetModified(); ////// Marks specified property as modified. /// /// This API recognizes the names in terms of OSpace ///If State is not Modified or Unchanged /// abstract public void SetModifiedProperty(string propertyName); ////// Returns the RelationshipManager for the entity represented by this ObjectStateEntry. /// Note that a RelationshipManager objects can only be returned if this entry represents a /// full entity. Key-only entries (stubs) and entries representing relationships do not /// have associated RelationshipManagers. /// ///The entry is a stub or represents a relationship abstract public RelationshipManager RelationshipManager { get; } ////// Changes state of the entry to the specified /// The requested state abstract public void ChangeState(EntityState state); ////// /// Apply modified properties to the original object. /// /// object with modified properties abstract public void ApplyCurrentValues(object currentEntity); ////// Apply original values to the entity. /// /// The object with original values abstract public void ApplyOriginalValues(object originalEntity); #endregion // Public members #region IEntityStateEntry IEntityStateManager IEntityStateEntry.StateManager { get { return (IEntityStateManager)this.ObjectStateManager; } } // must explicitly implement this because interface is internal & so is the property on the // class itself -- apparently the compiler won't let anything marked as internal be part of // an interface (even if the interface is also internal) bool IEntityStateEntry.IsKeyEntry { get { return this.IsKeyEntry; } } #endregion // IEntityStateEntry #region Public IEntityChangeTracker ////// Used to report that a scalar entity property is about to change /// The current value of the specified property is cached when this method is called. /// /// The name of the entity property that is changing void IEntityChangeTracker.EntityMemberChanging(string entityMemberName) { this.EntityMemberChanging(entityMemberName); } ////// Used to report that a scalar entity property has been changed /// The property value that was cached during EntityMemberChanging is now /// added to OriginalValues /// /// The name of the entity property that has changing void IEntityChangeTracker.EntityMemberChanged(string entityMemberName) { this.EntityMemberChanged(entityMemberName); } ////// Used to report that a complex property is about to change /// The current value of the specified property is cached when this method is called. /// /// The name of the top-level entity property that is changing /// The complex object that contains the property that is changing /// The name of the property that is changing on complexObject void IEntityChangeTracker.EntityComplexMemberChanging(string entityMemberName, object complexObject, string complexObjectMemberName) { this.EntityComplexMemberChanging(entityMemberName, complexObject, complexObjectMemberName); } ////// Used to report that a complex property has been changed /// The property value that was cached during EntityMemberChanging is now added to OriginalValues /// /// The name of the top-level entity property that has changed /// The complex object that contains the property that changed /// The name of the property that changed on complexObject void IEntityChangeTracker.EntityComplexMemberChanged(string entityMemberName, object complexObject, string complexObjectMemberName) { this.EntityComplexMemberChanged(entityMemberName, complexObject, complexObjectMemberName); } ////// Returns the EntityState from the ObjectStateEntry /// EntityState IEntityChangeTracker.EntityState { get { return this.State; } } #endregion // IEntityChangeTracker #region Internal members abstract internal bool IsKeyEntry { get; } abstract internal int GetFieldCount(StateManagerTypeMetadata metadata); abstract internal Type GetFieldType(int ordinal, StateManagerTypeMetadata metadata); abstract internal string GetCLayerName(int ordinal, StateManagerTypeMetadata metadata); abstract internal int GetOrdinalforCLayerName(string name, StateManagerTypeMetadata metadata); abstract internal void RevertDelete(); abstract internal void SetModifiedAll(); abstract internal void EntityMemberChanging(string entityMemberName); abstract internal void EntityMemberChanged(string entityMemberName); abstract internal void EntityComplexMemberChanging(string entityMemberName, object complexObject, string complexObjectMemberName); abstract internal void EntityComplexMemberChanged(string entityMemberName, object complexObject, string complexObjectMemberName); ////// Reuse or create a new (Entity)DataRecordInfo. /// abstract internal DataRecordInfo GetDataRecordInfo(StateManagerTypeMetadata metadata, object userObject); virtual internal void Reset() { _cache = null; _entitySet = null; _state = EntityState.Detached; } internal void ValidateState() { if (_state == EntityState.Detached) { throw EntityUtil.ObjectStateEntryinInvalidState(); } Debug.Assert(null != _cache, "null ObjectStateManager"); Debug.Assert(null != _entitySet, "null EntitySetBase"); } #endregion // Internal members } internal struct StateManagerValue { internal StateManagerMemberMetadata memberMetadata; internal object userObject; internal object originalValue; internal StateManagerValue(StateManagerMemberMetadata metadata, object instance, object value) { memberMetadata = metadata; userObject = instance; originalValue = value; } } internal enum ObjectStateValueRecord { OriginalReadonly = 0, CurrentUpdatable = 1, OriginalUpdatableInternal = 2, OriginalUpdatablePublic = 3, } // This class is used in Referential Integrity Constraints feature. // It is used to get around the problem of enumerating dictionary contents, // but allowing update of the value without breaking the enumerator. internal sealed class IntBox { private int val; internal IntBox(int val) { this.val = val; } internal int Value { get { return val; } set { val = value; } } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. //---------------------------------------------------------------------- //// Copyright (c) Microsoft Corporation. All rights reserved. // // // @owner [....] // @backupOwner [....] //--------------------------------------------------------------------- using System.Collections.Generic; using System.Data.Common; using System.Data.Metadata.Edm; using System.Data.Objects.DataClasses; using System.Diagnostics; using System.Collections; namespace System.Data.Objects { // Detached - nothing // Added - _entity & _currentValues only for shadowState // Unchanged - _entity & _currentValues only for shadowState // Unchanged -> Deleted - _entity & _currentValues only for shadowState // Modified - _currentValues & _modifiedFields + _originalValues only on change // Modified -> Deleted - _currentValues & _modifiedFields + _originalValues only on change ////// Represets either a entity, entity stub or relationship /// public abstract class ObjectStateEntry : IEntityStateEntry, IEntityChangeTracker { #region common entry fields internal ObjectStateManager _cache; internal EntitySetBase _entitySet; internal EntityState _state; #endregion #region Constructor // ObjectStateEntry will not be detached and creation will be handled from ObjectStateManager internal ObjectStateEntry(ObjectStateManager cache, EntitySet entitySet, EntityState state) { Debug.Assert(cache != null, "cache cannot be null."); _cache = cache; _entitySet = entitySet; _state = state; } #endregion // Constructor #region Public members ////// ObjectStateManager property of ObjectStateEntry. /// /// ///ObjectStateManager public ObjectStateManager ObjectStateManager { get { ValidateState(); return _cache; } } ///Extent property of ObjectStateEntry. /// ///Extent public EntitySetBase EntitySet { get { ValidateState(); return _entitySet; } } ////// State property of ObjectStateEntry. /// /// ///DataRowState public EntityState State { get { return _state; } internal set { _state = value; } } ////// Entity property of ObjectStateEntry. /// /// ///The entity encapsulated by this entry. abstract public object Entity { get; } ////// The EntityKey associated with the ObjectStateEntry /// abstract public EntityKey EntityKey { get; internal set; } ////// Determines if this ObjectStateEntry represents a relationship /// abstract public bool IsRelationship { get; } ////// Gets bit array indicating which properties are modified. /// abstract internal BitArray ModifiedProperties { get; } BitArray IEntityStateEntry.ModifiedProperties { get { return this.ModifiedProperties; } } ////// Original values of entity /// /// ///DbDataRecord [DebuggerBrowsable(DebuggerBrowsableState.Never)] // don't have debugger view expand this abstract public DbDataRecord OriginalValues { get; } abstract public OriginalValueRecord GetUpdatableOriginalValues(); ////// Current values of entity/ DataRow /// /// ///DbUpdatableDataRecord [DebuggerBrowsable(DebuggerBrowsableState.Never)] // don't have debugger view expand this abstract public CurrentValueRecord CurrentValues { get; } ////// API to accept the current values as original values and mark the entity as Unchanged. /// /// ///abstract public void AcceptChanges(); /// /// API to mark the entity deleted. if entity is in added state, it will be detached /// /// ///abstract public void Delete(); /// /// API to return properties that are marked modified /// /// ///IEnumerable of modified properties names, names are in term of c-space abstract public IEnumerableGetModifiedProperties(); /// /// set the state to Modified. /// /// ////// If State is not Modified or Unchanged /// abstract public void SetModified(); ////// Marks specified property as modified. /// /// This API recognizes the names in terms of OSpace ///If State is not Modified or Unchanged /// abstract public void SetModifiedProperty(string propertyName); ////// Returns the RelationshipManager for the entity represented by this ObjectStateEntry. /// Note that a RelationshipManager objects can only be returned if this entry represents a /// full entity. Key-only entries (stubs) and entries representing relationships do not /// have associated RelationshipManagers. /// ///The entry is a stub or represents a relationship abstract public RelationshipManager RelationshipManager { get; } ////// Changes state of the entry to the specified /// The requested state abstract public void ChangeState(EntityState state); ////// /// Apply modified properties to the original object. /// /// object with modified properties abstract public void ApplyCurrentValues(object currentEntity); ////// Apply original values to the entity. /// /// The object with original values abstract public void ApplyOriginalValues(object originalEntity); #endregion // Public members #region IEntityStateEntry IEntityStateManager IEntityStateEntry.StateManager { get { return (IEntityStateManager)this.ObjectStateManager; } } // must explicitly implement this because interface is internal & so is the property on the // class itself -- apparently the compiler won't let anything marked as internal be part of // an interface (even if the interface is also internal) bool IEntityStateEntry.IsKeyEntry { get { return this.IsKeyEntry; } } #endregion // IEntityStateEntry #region Public IEntityChangeTracker ////// Used to report that a scalar entity property is about to change /// The current value of the specified property is cached when this method is called. /// /// The name of the entity property that is changing void IEntityChangeTracker.EntityMemberChanging(string entityMemberName) { this.EntityMemberChanging(entityMemberName); } ////// Used to report that a scalar entity property has been changed /// The property value that was cached during EntityMemberChanging is now /// added to OriginalValues /// /// The name of the entity property that has changing void IEntityChangeTracker.EntityMemberChanged(string entityMemberName) { this.EntityMemberChanged(entityMemberName); } ////// Used to report that a complex property is about to change /// The current value of the specified property is cached when this method is called. /// /// The name of the top-level entity property that is changing /// The complex object that contains the property that is changing /// The name of the property that is changing on complexObject void IEntityChangeTracker.EntityComplexMemberChanging(string entityMemberName, object complexObject, string complexObjectMemberName) { this.EntityComplexMemberChanging(entityMemberName, complexObject, complexObjectMemberName); } ////// Used to report that a complex property has been changed /// The property value that was cached during EntityMemberChanging is now added to OriginalValues /// /// The name of the top-level entity property that has changed /// The complex object that contains the property that changed /// The name of the property that changed on complexObject void IEntityChangeTracker.EntityComplexMemberChanged(string entityMemberName, object complexObject, string complexObjectMemberName) { this.EntityComplexMemberChanged(entityMemberName, complexObject, complexObjectMemberName); } ////// Returns the EntityState from the ObjectStateEntry /// EntityState IEntityChangeTracker.EntityState { get { return this.State; } } #endregion // IEntityChangeTracker #region Internal members abstract internal bool IsKeyEntry { get; } abstract internal int GetFieldCount(StateManagerTypeMetadata metadata); abstract internal Type GetFieldType(int ordinal, StateManagerTypeMetadata metadata); abstract internal string GetCLayerName(int ordinal, StateManagerTypeMetadata metadata); abstract internal int GetOrdinalforCLayerName(string name, StateManagerTypeMetadata metadata); abstract internal void RevertDelete(); abstract internal void SetModifiedAll(); abstract internal void EntityMemberChanging(string entityMemberName); abstract internal void EntityMemberChanged(string entityMemberName); abstract internal void EntityComplexMemberChanging(string entityMemberName, object complexObject, string complexObjectMemberName); abstract internal void EntityComplexMemberChanged(string entityMemberName, object complexObject, string complexObjectMemberName); ////// Reuse or create a new (Entity)DataRecordInfo. /// abstract internal DataRecordInfo GetDataRecordInfo(StateManagerTypeMetadata metadata, object userObject); virtual internal void Reset() { _cache = null; _entitySet = null; _state = EntityState.Detached; } internal void ValidateState() { if (_state == EntityState.Detached) { throw EntityUtil.ObjectStateEntryinInvalidState(); } Debug.Assert(null != _cache, "null ObjectStateManager"); Debug.Assert(null != _entitySet, "null EntitySetBase"); } #endregion // Internal members } internal struct StateManagerValue { internal StateManagerMemberMetadata memberMetadata; internal object userObject; internal object originalValue; internal StateManagerValue(StateManagerMemberMetadata metadata, object instance, object value) { memberMetadata = metadata; userObject = instance; originalValue = value; } } internal enum ObjectStateValueRecord { OriginalReadonly = 0, CurrentUpdatable = 1, OriginalUpdatableInternal = 2, OriginalUpdatablePublic = 3, } // This class is used in Referential Integrity Constraints feature. // It is used to get around the problem of enumerating dictionary contents, // but allowing update of the value without breaking the enumerator. internal sealed class IntBox { private int val; internal IntBox(int val) { this.val = val; } internal int Value { get { return val; } set { val = value; } } } } // 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
- RegexInterpreter.cs
- OAVariantLib.cs
- UInt64Storage.cs
- DefaultValidator.cs
- Trigger.cs
- DesignConnectionCollection.cs
- MetadataCache.cs
- FileUtil.cs
- PropertyEntry.cs
- RepeaterItem.cs
- ModifiableIteratorCollection.cs
- MouseActionConverter.cs
- FamilyMap.cs
- ComboBoxItem.cs
- SerializationFieldInfo.cs
- ExceptionHelpers.cs
- ContainerUIElement3D.cs
- GridViewUpdateEventArgs.cs
- SqlClientFactory.cs
- DropDownButton.cs
- AdapterDictionary.cs
- FreezableOperations.cs
- WizardStepBase.cs
- ScrollData.cs
- SiteMapPath.cs
- TextFormatterHost.cs
- ListViewDeleteEventArgs.cs
- CLSCompliantAttribute.cs
- XmlSchemaIdentityConstraint.cs
- CryptoApi.cs
- ImageSourceValueSerializer.cs
- PersonalizableTypeEntry.cs
- Clock.cs
- Int32Rect.cs
- GrammarBuilderWildcard.cs
- AsyncPostBackErrorEventArgs.cs
- _SSPISessionCache.cs
- AsyncOperation.cs
- XhtmlMobileTextWriter.cs
- SafeNativeMethods.cs
- LassoSelectionBehavior.cs
- Pen.cs
- MultiByteCodec.cs
- GeneralTransformGroup.cs
- EncoderParameters.cs
- TextChange.cs
- CodePageUtils.cs
- InkCanvasFeedbackAdorner.cs
- AlternateViewCollection.cs
- GridToolTip.cs
- HttpApplication.cs
- FigureParaClient.cs
- SiteMapSection.cs
- PasswordDeriveBytes.cs
- Int32Storage.cs
- CopyOnWriteList.cs
- WebReferencesBuildProvider.cs
- KeysConverter.cs
- DescriptionCreator.cs
- MouseActionConverter.cs
- QilChoice.cs
- WsdlInspector.cs
- TabRenderer.cs
- ObjectManager.cs
- ListControl.cs
- InstalledVoice.cs
- ProviderConnectionPointCollection.cs
- FixUp.cs
- StateDesigner.TransitionInfo.cs
- ToolStripMenuItemCodeDomSerializer.cs
- TextDecorationCollection.cs
- MenuItemCollectionEditor.cs
- ResponseBodyWriter.cs
- EntityDataSourceWrapper.cs
- PropertyChangingEventArgs.cs
- QueryOpeningEnumerator.cs
- ToolStrip.cs
- _NegoStream.cs
- Screen.cs
- XmlWriterTraceListener.cs
- OptimisticConcurrencyException.cs
- Accessors.cs
- FacetDescription.cs
- DataAccessException.cs
- SchemaDeclBase.cs
- MarkupExtensionSerializer.cs
- ConfigPathUtility.cs
- RegionIterator.cs
- VirtualPath.cs
- ColorPalette.cs
- LineGeometry.cs
- StyleXamlParser.cs
- tooltip.cs
- Configuration.cs
- XappLauncher.cs
- HuffmanTree.cs
- LoadGrammarCompletedEventArgs.cs
- HwndSourceKeyboardInputSite.cs
- InstanceKeyNotReadyException.cs
- XmlAtomicValue.cs