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.
///
///
///
/// 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 IEnumerable GetModifiedProperties();
///
/// 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.
///
///
///
/// 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 IEnumerable GetModifiedProperties();
///
/// 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
- InvalidOleVariantTypeException.cs
- RSAPKCS1SignatureFormatter.cs
- Claim.cs
- StandardCommands.cs
- AlphaSortedEnumConverter.cs
- AttributeCollection.cs
- NativeMethodsOther.cs
- DbMetaDataColumnNames.cs
- SafeHandles.cs
- ColumnMapVisitor.cs
- DropSource.cs
- ClientSettingsStore.cs
- ImportRequest.cs
- TextDecorationLocationValidation.cs
- IntSecurity.cs
- StaticExtension.cs
- ObjectDataSourceMethodEventArgs.cs
- ValueProviderWrapper.cs
- SqlDataSourceCommandEventArgs.cs
- RegexStringValidatorAttribute.cs
- AstTree.cs
- CultureData.cs
- TextTreeTextBlock.cs
- FileAuthorizationModule.cs
- Itemizer.cs
- WindowShowOrOpenTracker.cs
- UTF32Encoding.cs
- AssemblySettingAttributes.cs
- EnumerableRowCollection.cs
- GcHandle.cs
- DataGridViewImageColumn.cs
- SerializationInfoEnumerator.cs
- Application.cs
- HttpInputStream.cs
- TimeIntervalCollection.cs
- InitializationEventAttribute.cs
- RawAppCommandInputReport.cs
- COM2ColorConverter.cs
- SiteMapNodeItem.cs
- SourceSwitch.cs
- Bidi.cs
- ManualResetEvent.cs
- SID.cs
- PiiTraceSource.cs
- PropertyPathWorker.cs
- TimeSpanConverter.cs
- HtmlInputPassword.cs
- SafePipeHandle.cs
- MeshGeometry3D.cs
- TdsParserStaticMethods.cs
- TransportChannelFactory.cs
- NotImplementedException.cs
- BindingOperations.cs
- DBCommandBuilder.cs
- TableRow.cs
- SqlDataSourceStatusEventArgs.cs
- HwndStylusInputProvider.cs
- MailAddressCollection.cs
- TextControl.cs
- BasicExpandProvider.cs
- DataServiceExpressionVisitor.cs
- ListSourceHelper.cs
- EntityContainerAssociationSet.cs
- ReceiveSecurityHeaderElementManager.cs
- TextSelectionHelper.cs
- ComAdminInterfaces.cs
- AncillaryOps.cs
- XXXInfos.cs
- TaiwanLunisolarCalendar.cs
- InvalidOleVariantTypeException.cs
- Wizard.cs
- IncrementalReadDecoders.cs
- ConfigUtil.cs
- WindowCollection.cs
- PenLineCapValidation.cs
- IdnMapping.cs
- WebPartTracker.cs
- COM2ICategorizePropertiesHandler.cs
- CodeExporter.cs
- Types.cs
- WebPartEventArgs.cs
- ToolStripPanelRow.cs
- UnsafeNativeMethodsTablet.cs
- OptimizedTemplateContentHelper.cs
- ObjectReferenceStack.cs
- Subordinate.cs
- PartialCachingAttribute.cs
- HttpPostedFileWrapper.cs
- HiddenFieldPageStatePersister.cs
- IndependentAnimationStorage.cs
- SecurityContext.cs
- PanningMessageFilter.cs
- AspNetSynchronizationContext.cs
- InputScopeManager.cs
- VirtualizingStackPanel.cs
- PathFigureCollectionConverter.cs
- ObjectSecurity.cs
- BorderGapMaskConverter.cs
- activationcontext.cs
- AdRotator.cs