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 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ý |
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
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro