This documentation is archived and is not being maintained.

ObjectContext.ObjectStateManager Property

Gets the object state manager used by the object context to track object changes.

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

Public ReadOnly Property ObjectStateManager As ObjectStateManager

These examples are based on the Adventure Works Sales Model. This example gets the ObjectStateManager from the ObjectContext and uses the state manager to access an object in the context.

Dim orderId As Integer = 43680

Using context As New AdventureWorksEntities()
    Dim objectStateManager As ObjectStateManager = context.ObjectStateManager
    Dim stateEntry As ObjectStateEntry = Nothing

    Dim order = (From o In context.SalesOrderHeaders
        Where o.SalesOrderID = orderId
        Select o).First()

    ' Attempts to retrieve ObjectStateEntry for the given EntityKey. 
    Dim isPresent As Boolean = objectStateManager.TryGetObjectStateEntry(DirectCast(order, IEntityWithKey).EntityKey, stateEntry)
    If isPresent Then
        Console.WriteLine("The entity was found")
    End If
End Using

This example uses the TryGetObjectStateEntry method on the returned ObjectStateManager to get an object based on its entity key.

Private Shared Sub ApplyItemUpdates(ByVal originalItem As SalesOrderDetail, ByVal updatedItem As SalesOrderDetail)
    Using context As New AdventureWorksEntities()
        ' Check if the ID is 0, if it is the item is new. 
        ' In this case we need to chage the state to Added. 
        If updatedItem.SalesOrderDetailID = 0 Then
            ' Because the ID is generated by the database we do not need to 
            ' set updatedItem.SalesOrderDetailID. 
            context.ObjectStateManager.ChangeObjectState(updatedItem, System.Data.EntityState.Added)
            ' If the SalesOrderDetailID is not 0, then the item is not new 
            ' and needs to be updated. Because we already added the 
            ' updated object to the context we need to apply the original values. 
            ' If we attached originalItem to the context 
            ' we would need to apply the current values: 
            ' context.ApplyCurrentValues("SalesOrderDetails", updatedItem); 
            ' Applying current or original values, changes the state 
            ' of the attached object to Modified. 
            context.ApplyOriginalValues("SalesOrderDetails", originalItem)
        End If
    End Using
End Sub

.NET Framework

Supported in: 4, 3.5 SP1

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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