ObjectStateManager 類別

定義

命名空間:

System.Data.Objects

組件:

System.Data.Entity.dll

維護實體類型實例與關聯實例的物件狀態與身份管理。

public ref class ObjectStateManager

public class ObjectStateManager

type ObjectStateManager = class

Public Class ObjectStateManager

繼承

Object

ObjectStateManager

範例

以下範例從 ObjectContext 取得 ，ObjectStateManager並使用狀態管理器存取上下文中的物件。

int orderId = 43680;

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    ObjectStateManager objectStateManager = context.ObjectStateManager;
    ObjectStateEntry stateEntry = null;

    var order = (from o in context.SalesOrderHeaders
                 where o.SalesOrderID == orderId
                 select o).First();

    // Attempts to retrieve ObjectStateEntry for the given EntityKey.
    bool isPresent = objectStateManager.TryGetObjectStateEntry(((IEntityWithKey)order).EntityKey, out stateEntry);
    if (isPresent)
    {
        Console.WriteLine("The entity was found");
    }
}

以下範例使用 TryGetObjectStateEntry(EntityKey, ObjectStateEntry) 了 返回 上 ObjectStateManager 的方法，根據其實體鍵數取得物件。

private static void ApplyItemUpdates(SalesOrderDetail originalItem,
    SalesOrderDetail updatedItem)
{
    using (AdventureWorksEntities context =
        new AdventureWorksEntities())
    {
        context.SalesOrderDetails.Attach(updatedItem);
        // 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)
        {
            // Because the ID is generated by the database we do not need to
            // set updatedItem.SalesOrderDetailID.
            context.ObjectStateManager.ChangeObjectState(updatedItem, System.Data.EntityState.Added);
        }
        else
        {
            // 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);
        }
        context.SaveChanges();
    }
}

備註

ObjectStateManager 追蹤查詢結果，並提供合併多個重疊查詢結果的邏輯。 當使用者插入、刪除或修改物件時，它還能執行記憶體內的變更追蹤，並提供更新的變更集。 變更集被變更處理器用來持久化修改。

此類別通常用於 ObjectContext 應用，而非直接應用。

建構函式

名稱	Description
ObjectStateManager(MetadataWorkspace)	初始化 ObjectStateManager 類別的新執行個體。

屬性

名稱	Description
MetadataWorkspace	他會和 MetadataWorkspace 這個州經理有關聯。

方法

名稱	Description
ChangeObjectState(Object, EntityState)	將特定物件的狀態 ObjectStateEntry 變更為指定的 entityState。
ChangeRelationshipState(Object, Object, String, EntityState)	改變兩個實體物件間關係的狀態，該關係是根據兩個相關物件及導航屬性的名稱所指定的。
ChangeRelationshipState(Object, Object, String, String, EntityState)	改變兩個實體物件間基於兩個相關物件及其屬性所指定的關係狀態。
ChangeRelationshipState<TEntity>(TEntity, Object, Expression<Func<TEntity,Object>>, EntityState)	變更兩個實體物件間關係的狀態，該關係是基於兩個相關物件及定義導航屬性的 LINQ 表達式所指定的。
Equals(Object)	判斷指定的 物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetObjectStateEntries(EntityState)	回傳一組 ObjectStateEntry 物件，針對與給定狀態的物件或關係。
GetObjectStateEntry(EntityKey)	回傳物件或關聯項目的 a ObjectStateEntry ，並指定金鑰。
GetObjectStateEntry(Object)	回傳指定物件的 a ObjectStateEntry 。
GetRelationshipManager(Object)	回傳 RelationshipManager 指定物件所使用的 that。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
TryGetObjectStateEntry(EntityKey, ObjectStateEntry)	嘗試取得與指定EntityKey物件或關係的對應 ObjectStateEntry 。
TryGetObjectStateEntry(Object, ObjectStateEntry)	嘗試取得 ObjectStateEntry 對應 Object的 。
TryGetRelationshipManager(Object, RelationshipManager)	回傳 RelationshipManager 指定物件所使用的 that。

事件

名稱	Description
ObjectStateManagerChanged	當實體被加入或移除狀態管理者時，會發生這種情況。