ObjectContext.ApplyCurrentValues<TEntity> Method
Copies the scalar values from the supplied object into 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 ApplyCurrentValues<TEntity>( string entitySetName, TEntity currentEntity ) where TEntity : class
Type Parameters
- TEntity
The entity type of the object.
Parameters
- entitySetName
- Type: System.String
The name of the entity set to which the object belongs.
- currentEntity
- Type: TEntity
The detached object that has property updates to apply to the original object. The entity key of currentEntity must match the EntityKey property of an entry in the ObjectContext.
Return Value
Type: TEntityThe updated object.
| Exception | Condition |
|---|---|
| ArgumentNullException | entitySetName or current is null. |
| InvalidOperationException | The EntitySet from entitySetName does not match the EntitySet of the object’s EntityKey. -or- The object is not in the ObjectStateManager or it is in a Detached state. -or- The entity key of the supplied object is invalid. |
| ArgumentException | entitySetName is an empty string. |
The ApplyCurrentValues<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 original values of the object are marked as modified. Note, the method does not apply the current values to the related objects of currentEntity.
If you have a graph with the current values and want to apply the original values, call ApplyOriginalValues<TEntity> method.
You may also use the ApplyCurrentValues of the ObjectSet<TEntity> or ApplyCurrentValues method of the ObjectStateEntry. For more information, see Building N-Tier Applications.
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.
