ObjectStateManager Třída

Definice

Obor názvů:

System.Data.Objects

Sestavení:

System.Data.Entity.dll

Udržuje stav objektu a správu identit pro instance typů entit a instance relací.

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žívá 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) vrácené ObjectStateManager 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 dotazu a poskytuje logiku pro sloučení více překrývajících se výsledků dotazu. Provádí také sledování změn v paměti, když uživatel vloží, odstraní nebo upraví objekty a poskytne 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 není přímo v aplikacích.

Konstruktory

Name	Description
ObjectStateManager(MetadataWorkspace)	Inicializuje novou instanci ObjectStateManager třídy.

Vlastnosti

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

Metody

Name	Description
ChangeObjectState(Object, EntityState)	Změní stav konkrétního ObjectStateEntry objektu na zadaný entityStateobjekt .
ChangeRelationshipState(Object, Object, String, EntityState)	Změní stav relace mezi dvěma objekty entity, které jsou zadané na základě dvou souvisejících objektů a názvu navigační vlastnosti.
ChangeRelationshipState(Object, Object, String, String, EntityState)	Změní stav relace mezi dvěma objekty entity, které jsou zadané 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é jsou zadány 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í funkce hash. (Zděděno od Object)
GetObjectStateEntries(EntityState)	Vrátí kolekci ObjectStateEntry objektů pro objekty nebo relace s daným stavem.
GetObjectStateEntry(EntityKey)	ObjectStateEntry Vrátí pro objekt nebo položku relace se zadaným klíčem.
GetObjectStateEntry(Object)	Vrátí hodnotu ObjectStateEntry pro zadaný objekt.
GetRelationshipManager(Object)	RelationshipManager Vrátí hodnotu použitou zadaným objektem.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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 pro zadaný Object.
TryGetRelationshipManager(Object, RelationshipManager)	RelationshipManager Vrátí hodnotu použitou zadaným objektem.

Událost

Name	Description
ObjectStateManagerChanged	Nastane, když jsou entity přidány nebo odebrány ze správce stavů.