Export (0) Print
Expand All

ObjectContext.ApplyOriginalValues<TEntity> Method

Copies the scalar values from the supplied object into set of original values for the object in the ObjectContext that has the same key.

Namespace:  System.Data.Objects
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

public TEntity ApplyOriginalValues<TEntity>(
	string entitySetName,
	TEntity originalEntity
)
where TEntity : class

Type Parameters

TEntity

The type of the entity object.

Parameters

entitySetName
Type: System.String

The name of the entity set to which the object belongs.

originalEntity
Type: TEntity

The detached object that has original values to apply to the object. The entity key of originalEntity must match the EntityKey property of an entry in the ObjectContext.

Return Value

Type: TEntity
The updated object.

ExceptionCondition
ArgumentNullException

entitySetName or original is null.

InvalidOperationException

The EntitySet from entitySetName does not match the EntitySet of the object’s EntityKey.

-or-

An ObjectStateEntry for the object cannot be found in the ObjectStateManager. -or-

The object is in an Added or a Detached state.

-or-

The entity key of the supplied object is invalid or has property changes.

ArgumentException

entitySetName is an empty string.

The ApplyOriginalValues<TEntity> method is used to apply changes that were made to objects outside the ObjectContext, such as detached objects that are received by a Web service. The method copies the scalar values from the supplied object into the object in the ObjectContext that has the same key. You can use the EntityKey of the detached object to retrieve an instance of this object from the data source. For more information, see How to: Return a Specific Object Using its Key (Entity Framework). Any values that differ from the current values of the object are marked as modified. Note, the method does not apply the current values to the related objects of originalEntity.

If you have a graph with the original values and want to apply the current values, call ApplyCurrentValues<TEntity> method.

You may also use the ApplyOriginalValues of the ObjectSet<TEntity> or ApplyOriginalValues method of the ObjectStateEntry. For more information, see Building N-Tier Applications.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft