DBEntityEntry Class

DBEntityEntry is an important class, which is useful in retrieving various information about an entity. You can get an instance of DBEntityEntry of a particular entity by using Entry method of DBContext. For example:

DBEntityEntry studentEntry = dbcontext.Entry(StudentEntity);

DBEntityEntry enables you to access entity state, current, and original values of all the property of a given entity. The following example code shows how to retrieve important information of a particular entity.

using (var dbCtx = new SchoolDBEntities())
{
//get student whose StudentId is 1
var student = dbCtx.Students.Find();

//edit student name  
student.StudentName = "Edited name";

//get DbEntityEntry object for student entity object  
var entry = dbCtx.Entry(student);

//get entity information e.g. full name  
Console.WriteLine("Entity Name: {0}", entry.Entity.GetType().FullName);

//get current EntityState  
Console.WriteLine("Entity State: {0}", entry.State );

Console.WriteLine("\*\*\*\*\*\*\*\*Property Values\*\*\*\*\*\*\*\*");

foreach (var propertyName in entry.CurrentValues.PropertyNames )  
{  
    Console.WriteLine("Property Name: {0}", propertyName);

    //get original value  
    var orgVal = entry.OriginalValues\[propertyName\];  
    Console.WriteLine("     Original Value: {0}", orgVal);

    //get current values  
    var curVal = entry.CurrentValues\[propertyName\];  
    Console.WriteLine("     Current Value: {0}", curVal);  
}

}

Output:

Entity Name: Student 
Entity State: Modified 
********Property Values********
Property Name: StudentID
Original Value: 1
Current Value: 1
Property Name: StudentName 
Original Value: First Student Name 
Current Value: Edited name 
Property Name: StandardId
Original Value:
Current Value:

DbEntityEntry enables you to set Added, Modified or Deleted EntityState to an entity as shown below.

context.Entry(student).State = System.Data.Entity.EntityState.Modified;

DBEntityEntry class has the following important methods:

Method Name

Return Type

Description

Collection

DBCollectionEntry

Gets an object that represents the collection navigation property from this entity to a collection of related entities.

Example:
var studentDBEntityEntry = dbContext.Entry(studentEntity); 
var collectionProperty = studentDBEntityEntry.Collection(s => s.Courses);

ComplexProperty

DBComplexPropertyEntry

Gets an object that represents a complex property of this entity. 
Example:
var studentDBEntityEntry = dbContext.Entry(studentEntity); 
var complexProperty = studentDBEntityEntry.ComplexProperty(stud.StudentStandard);

GetDatabaseValues

DBPropertyValues

Queries the database for copies of the values of the tracked entity as they currently exist in the database. Changing the values in the returned dictionary will not update the values in the database. If the entity is not found in the database then null is returned.
Example:
var studentDBEntityEntry = dbContext.Entry(studentEntity);
var dbPropValues = studentDBEntityEntry.GetDatabaseValues();

Property

DBPropertyEntry

Gets an object that represents a scalar or complex property of this entity.
Example:
var studentDBEntityEntry = dbContext.Entry(studentEntity); 
string propertyName = studentDBEntityEntry.Property("StudentName").Name;

Reference

DBReferenceEntry

Gets an object that represents the reference (i.e. non-collection) navigation property from this entity to another entity.
Example:
var studentDBEntityEntry = dbContext.Entry(studentEntity); 
var referenceProperty = studentDBEntityEntry.Reference(s => s.Standard);

Reload

void

Reloads the entity from the database overwriting any property values with values from the database. The entity will be in the Unchanged state after calling this method.
Example:
var studentDBEntityEntry = dbContext.Entry(studentEntity);
studentDBEntityEntry.Reload();

Visit MSND for more information on DBEntityEntry class.