ObjectStateManager Třída

Definice

Obor názvů:

System.Data.Objects

Sestavení:

System.Data.Entity.dll

Udržuje správu stavu objektů a identit pro instance typu entity a instance vztahů.

public ref class ObjectStateManager

public class ObjectStateManager

type ObjectStateManager = class

Public Class ObjectStateManager

Dědičnost

Object

ObjectStateManager

Příklady

Následující příklad získá ObjectStateManager z ObjectContext a použije správce stavu pro přístup k objektu v kontextu.

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");
    }
}

Následující příklad používá metodu TryGetObjectStateEntry(EntityKey, ObjectStateEntry) pro vrácenou ObjectStateManager metodu k získání objektu na základě jeho klíče entity.

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();
    }
}

Poznámky

ObjectStateManager sleduje výsledky dotazů a poskytuje logiku pro sloučení několika překrývajících se výsledků dotazu. Provádí také sledování změn v paměti, když uživatel vkládá, odstraňuje nebo upravuje objekty a poskytuje sadu změn pro aktualizace. Tuto sadu změn používá procesor změn k zachování změn.

Tato třída se obvykle používá, ObjectContext a ne přímo v aplikacích.

Konstruktory

ObjectStateManager(MetadataWorkspace)

Inicializuje novou instanci ObjectStateManager třídy .

Vlastnosti

MetadataWorkspace

MetadataWorkspace Získá přidružený k tomuto správci stavu.

Metody

ChangeObjectState(Object, EntityState)	Změní stav konkrétního ObjectStateEntry objektu na zadaný entityState.
ChangeRelationshipState(Object, Object, String, EntityState)	Změní stav relace mezi dvěma objekty entity, který je určen na základě dvou souvisejících objektů a názvu navigační vlastnosti.
ChangeRelationshipState(Object, Object, String, String, EntityState)	Změní stav vztahu mezi dvěma objekty entity, který je určen na základě dvou souvisejících objektů a vlastností relace.
ChangeRelationshipState<TEntity>(TEntity, Object, Expression<Func<TEntity,Object>>, EntityState)	Změní stav relace mezi dvěma objekty entity, který je zadán na základě dvou souvisejících objektů a výraz LINQ, který definuje navigační vlastnost.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetObjectStateEntries(EntityState)	Vrátí kolekci ObjectStateEntry objektů pro objekty nebo vztahy s daným stavem.
GetObjectStateEntry(EntityKey)	Vrátí hodnotu ObjectStateEntry pro objekt nebo položku relace se zadaným klíčem.
GetObjectStateEntry(Object)	Vrátí hodnotu ObjectStateEntry pro zadaný objekt.
GetRelationshipManager(Object)	Vrátí hodnotu RelationshipManager , která je používána zadaným objektem.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TryGetObjectStateEntry(EntityKey, ObjectStateEntry)	Pokusí se načíst odpovídající ObjectStateEntry objekt nebo relaci se zadaným EntityKeyobjektem .
TryGetObjectStateEntry(Object, ObjectStateEntry)	Pokusí se načíst odpovídající ObjectStateEntry hodnotu pro zadaný Object.
TryGetRelationshipManager(Object, RelationshipManager)	Vrátí hodnotu RelationshipManager , která je používána zadaným objektem.

Událost

ObjectStateManagerChanged

Vyvolá se při přidání nebo odebrání entit ze správce stavu.