ObjectStateManager Třída

Definice

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

public ref class ObjectStateManager
public class ObjectStateManager
type ObjectStateManager = class
Public Class ObjectStateManager
Dědičnost
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) vrácenou ObjectStateManager k získání objektu na základě 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 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í úprav.

Tuto třídu obvykle používají 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ý entityStateobjekt .

ChangeRelationshipState(Object, Object, String, EntityState)

Změní stav relace mezi dvěma objekty entit, který je zadán na základě dvou souvisejících objektů a názvu vlastnosti navigace.

ChangeRelationshipState(Object, Object, String, String, EntityState)

Změní stav relace 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 vlastnost navigace.

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 relace 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 , kterou používá zadaný objekt.

GetType()

Získá aktuální Type instanci.

(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ý Objectparametr .

TryGetRelationshipManager(Object, RelationshipManager)

Vrátí hodnotu RelationshipManager , kterou používá zadaný objekt.

Událost

ObjectStateManagerChanged

Nastane, když jsou entity přidány do správce stavu nebo odebrány ze správce stavu.

Platí pro