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
- ToolBarButtonClickEvent.cs
- EndpointAddressAugust2004.cs
- WebPartEditVerb.cs
- EditorPartChrome.cs
- TemplateControl.cs
- PrimitiveSchema.cs
- EncodedStreamFactory.cs
- DataControlFieldCollection.cs
- Rect3DConverter.cs
- WpfWebRequestHelper.cs
- ClientConfigPaths.cs
- ProfileServiceManager.cs
- ColorInterpolationModeValidation.cs
- OpenFileDialog.cs
- UpdateRecord.cs
- CorePropertiesFilter.cs
- configsystem.cs
- BaseCodeDomTreeGenerator.cs
- AlternateViewCollection.cs
- QueryTask.cs
- HandleCollector.cs
- BoundingRectTracker.cs
- Vector3DKeyFrameCollection.cs
- ValidatingReaderNodeData.cs
- XmlParserContext.cs
- TimeSpanSecondsOrInfiniteConverter.cs
- Zone.cs
- DesignerCommandAdapter.cs
- EntityDataSourceUtil.cs
- PropertyValueChangedEvent.cs
- _FixedSizeReader.cs
- updatecommandorderer.cs
- ViewStateModeByIdAttribute.cs
- DrawListViewItemEventArgs.cs
- OperandQuery.cs
- TraceContext.cs
- FlowDocumentView.cs
- DataPagerFieldItem.cs
- AttachmentService.cs
- MetadataItemEmitter.cs
- ExpressionsCollectionConverter.cs
- HttpRequest.cs
- XmlDictionaryWriter.cs
- MemoryStream.cs
- X509RecipientCertificateServiceElement.cs
- ChannelCacheSettings.cs
- TextCharacters.cs
- DelegatedStream.cs
- StylusPointPropertyId.cs
- WindowsImpersonationContext.cs
- ValidatedControlConverter.cs
- MenuEventArgs.cs
- StrokeFIndices.cs
- DependencyProperty.cs
- PowerModeChangedEventArgs.cs
- PeerPresenceInfo.cs
- FrameworkContentElement.cs
- NamespaceInfo.cs
- UIntPtr.cs
- TableLayoutStyle.cs
- RequestContext.cs
- TableItemStyle.cs
- ImageField.cs
- XPathNodeHelper.cs
- DurableServiceAttribute.cs
- DataGridViewColumnConverter.cs
- ScheduleChanges.cs
- TextureBrush.cs
- GridViewUpdatedEventArgs.cs
- StructuralCache.cs
- PeerContact.cs
- AsymmetricSignatureDeformatter.cs
- RegularExpressionValidator.cs
- SpecularMaterial.cs
- InvalidContentTypeException.cs
- SqlBuilder.cs
- PassportAuthenticationModule.cs
- TextTrailingCharacterEllipsis.cs
- HierarchicalDataSourceControl.cs
- RequiredAttributeAttribute.cs
- SpecialTypeDataContract.cs
- PassportPrincipal.cs
- ObfuscationAttribute.cs
- CompoundFileStorageReference.cs
- MasterPageCodeDomTreeGenerator.cs
- sapiproxy.cs
- EventTrigger.cs
- Mapping.cs
- Utilities.cs
- DispatcherExceptionEventArgs.cs
- OdbcParameter.cs
- CommandLibraryHelper.cs
- InstanceNotReadyException.cs
- BinaryFormatter.cs
- Vector3D.cs
- DBSqlParser.cs
- milexports.cs
- Brush.cs
- Parsers.cs
- SmtpReplyReaderFactory.cs