ObjectStateManager Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
-
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ý |
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. |