ObjectContext Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lehetővé teszi az entitásadatok objektumként való lekérdezését és működését.
public ref class ObjectContext : IDisposable
public class ObjectContext : IDisposable
type ObjectContext = class
interface IDisposable
Public Class ObjectContext
Implements IDisposable
- Öröklődés
-
ObjectContext
- Megvalósítás
Példák
Ez a példa bemutatja, hogyan hozhat létre .ObjectContext
// Create the ObjectContext.
ObjectContext context =
new ObjectContext("name=AdventureWorksEntities");
// Set the DefaultContainerName for the ObjectContext.
// When DefaultContainerName is set, the Entity Framework only
// searches for the type in the specified container.
// Note that if a type is defined only once in the metadata workspace
// you do not have to set the DefaultContainerName.
context.DefaultContainerName = "AdventureWorksEntities";
ObjectSet<Product> query = context.CreateObjectSet<Product>();
// Iterate through the collection of Products.
foreach (Product result in query)
Console.WriteLine("Product Name: {0}", result.Name);
Megjegyzések
Note
Az ObjectContext osztály nem szálbiztos. Az adatobjektumok ObjectContext integritása többszálú forgatókönyvekben nem biztosítható.
Az ObjectContext osztály az adatok objektumként való kezeléséhez használt elsődleges osztály, amely a fogalmi modellben definiált entitástípusok példányai. Az osztály egy példánya a ObjectContext következőket foglalja magában:
Kapcsolat az adatbázissal objektum formájában EntityConnection .
A modellt leíró metaadatok objektum formájában MetadataWorkspace .
A ObjectStateManager gyorsítótárban tárolt objektum, amely az objektumokat kezeli.
Ha az entitás adatmodell eszközei létrehoznak egy fogalmi modellt képviselő objektumréteget, a modellhez EntityContainertartozó ObjectContext osztály a .
Konstruktorok
| Name | Description |
|---|---|
| ObjectContext(EntityConnection, String) |
Inicializálja az ObjectContext osztály új példányát egy adott kapcsolattal és entitástároló nevével. |
| ObjectContext(EntityConnection) |
Inicializálja az osztály új példányát ObjectContext a megadott kapcsolattal. Az építés során a metaadat-munkaterület ki lesz nyerve az EntityConnection objektumból. |
| ObjectContext(String, String) |
Inicializálja a ObjectContext osztály új példányát egy adott kapcsolati karakterlánc és entitástároló nevével. |
| ObjectContext(String) |
Inicializálja a ObjectContext osztály új példányát a megadott kapcsolati karakterlánc és alapértelmezett entitástároló nevével. |
Tulajdonságok
| Name | Description |
|---|---|
| CommandTimeout |
Másodpercek alatt lekéri vagy beállítja az időtúllépési értéket az összes objektumkörnyezeti művelethez. Az |
| Connection |
Lekéri az objektumkörnyezet által használt kapcsolatot. |
| ContextOptions |
Lekéri azt a ObjectContextOptions példányt, amely olyan beállításokat tartalmaz, amelyek befolyásolják a ObjectContext. |
| DefaultContainerName |
Lekéri vagy beállítja az alapértelmezett tárolónevet. |
| MetadataWorkspace |
Lekéri az objektumkörnyezet által használt metaadat-munkaterületet. |
| ObjectStateManager |
Lekéri az objektumkörnyezet által használt objektumállapot-kezelőt az objektumváltozások nyomon követéséhez. |
| QueryProvider |
Lekéri az objektumkörnyezethez társított LINQ-lekérdezésszolgáltatót. |
Metódusok
| Name | Description |
|---|---|
| AcceptAllChanges() |
Elfogadja az objektumkörnyezetben lévő objektumokon végrehajtott összes módosítást. |
| AddObject(String, Object) |
Objektumot ad hozzá az objektumkörnyezethez. |
| ApplyCurrentValues<TEntity>(String, TEntity) |
Másolja a megadott objektum skaláris értékeit az azonos kulccsal rendelkező objektumba ObjectContext . |
| ApplyOriginalValues<TEntity>(String, TEntity) |
Másolja a megadott objektum skaláris értékeit az azonos kulccsal rendelkező objektum ObjectContext eredeti értékeinek készletébe. |
| ApplyPropertyChanges(String, Object) |
Elavult.
Tulajdonságmódosításokat alkalmaz leválasztott objektumról az objektumkörnyezethez már csatolt objektumra. |
| Attach(IEntityWithKey) |
Objektumot vagy objektumdiagramot csatol az objektumkörnyezethez, ha az objektum entitáskulcsmal rendelkezik. |
| AttachTo(String, Object) |
Objektum- vagy objektumgráf csatolása egy adott entitáskészlet objektumkörnyezetéhez. |
| CreateDatabase() |
Az adatbázist az aktuális adatforrás-kapcsolat és a metaadatok használatával hozza létre a StoreItemCollection. |
| CreateDatabaseScript() |
Létrehoz egy adatdefiníciós nyelv (DDL) szkriptet, amely sémaobjektumokat (táblákat, elsődleges kulcsokat, idegen kulcsokat) hoz létre a metaadatokhoz a StoreItemCollection. A StoreItemCollection rendszer betölti a metaadatokat az áruház sémadefiníciós (SSDL) fájljaiból. |
| CreateEntityKey(String, Object) |
Létrehozza az entitáskulcsot egy adott objektumhoz, vagy visszaadja az entitáskulcsot, ha már létezik. |
| CreateObject<T>() |
Létrehozza és visszaadja a kért típusú példányt. |
| CreateObjectSet<TEntity>() |
Létrehoz egy új ObjectSet<TEntity> példányt, amely a megadott entitástípus objektumainak lekérdezésére, hozzáadására, módosítására és törlésére szolgál. |
| CreateObjectSet<TEntity>(String) |
Létrehoz egy új ObjectSet<TEntity> példányt, amely a megadott típusú és a megadott entitáskészlet-névvel rendelkező objektumok lekérdezésére, hozzáadására, módosítására és törlésére szolgál. |
| CreateProxyTypes(IEnumerable<Type>) |
Ezzel egyenértékű típust hoz létre, amely a megadott enumerálás minden típusához használható az Entity Framework használatával. |
| CreateQuery<T>(String, ObjectParameter[]) |
Létrehoz egy ObjectQuery<T> aktuális objektumkörnyezetet a megadott lekérdezési sztring használatával. |
| DatabaseExists() |
Ellenőrzi, hogy az aktuális adatforrás-kapcsolat adatbázisaként megadott adatbázis létezik-e az adatforráson. |
| DeleteDatabase() |
Törli az adatbázisként megadott adatbázist az aktuális adatforrás-kapcsolaton belül. |
| DeleteObject(Object) |
Objektum megjelölése törlésre. |
| Detach(Object) |
Eltávolítja az objektumot az objektumkörnyezetből. |
| DetectChanges() |
Biztosítja, hogy ObjectStateEntry a módosítások szinkronizálva legyenek az összes olyan objektum módosításaival, amelyeket a ObjectStateManagerrendszer nyomon követ. |
| Dispose() |
Felszabadítja az objektumkörnyezet által használt erőforrásokat. |
| Dispose(Boolean) |
Felszabadítja az objektumkörnyezet által használt erőforrásokat. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| ExecuteFunction(String, ObjectParameter[]) |
Az adatforrásban meghatározott és a fogalmi modellben kifejezett tárolt eljárást vagy függvényt hajt végre; elveti a függvényből visszaadott eredményeket; és visszaadja a végrehajtás által érintett sorok számát. |
| ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[]) |
Végrehajtja az adatforrásban definiált és a fogalmi modellben kifejezett tárolt eljárást vagy függvényt a megadott paraméterekkel és az egyesítési beállítással. Beírt értéket ad ObjectResult<T>vissza. |
| ExecuteFunction<TElement>(String, ObjectParameter[]) |
Végrehajt egy tárolt eljárást vagy függvényt, amely az adatforrásban van meghatározva, és a koncepcionális modellben van leképezve a megadott paraméterekkel. Beírt értéket ad ObjectResult<T>vissza. |
| ExecuteStoreCommand(String, Object[]) |
Egy tetszőleges parancsot hajt végre közvetlenül az adatforráson a meglévő kapcsolat használatával. |
| ExecuteStoreQuery<TElement>(String, Object[]) |
Közvetlenül az adatforrásra irányuló lekérdezést hajt végre, amely gépelt eredmények sorozatát adja vissza. |
| ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[]) |
Közvetlenül az adatforráson végrehajt egy lekérdezést, és gépelt eredményeket ad vissza. Adja meg az entitáskészletet és az egyesítési beállítást, hogy a lekérdezés eredményei entitásként nyomon követhetők legyenek. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetKnownProxyTypes() |
Az összes meglévő proxytípust adja vissza. |
| GetObjectByKey(EntityKey) |
A megadott entitáskulcsot tartalmazó objektumot ad vissza. |
| GetObjectType(Type) |
Egy megadott típusú proxyobjektumhoz társított POCO-entitás entitástípusát adja vissza. |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| LoadProperty(Object, String, MergeOption) |
Explicit módon betölt egy objektumot, amely a megadott navigációs tulajdonság által a megadott objektumhoz kapcsolódik, és a megadott egyesítési beállítást használja. |
| LoadProperty(Object, String) |
Explicit módon betölti a megadott navigációs tulajdonság által megadott objektumhoz kapcsolódó objektumot, és használja az alapértelmezett egyesítési beállítást. |
| LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption) |
Explicit módon betölt egy objektumot, amely a megadott LINQ-lekérdezés és a megadott egyesítési beállítás használatával kapcsolódik a megadott objektumhoz. |
| LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>) |
Explicit módon betölt egy objektumot, amely a megadott LINQ-lekérdezés és az alapértelmezett egyesítési beállítás használatával kapcsolódik a megadott objektumhoz. |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| Refresh(RefreshMode, IEnumerable) |
Frissíti az objektumkörnyezet objektumgyűjteményét az adatforrásból származó adatokkal. |
| Refresh(RefreshMode, Object) |
Frissíti az objektumkörnyezetben lévő objektumot az adatforrásból származó adatokkal. |
| SaveChanges() |
Megőrzi az adatforrás összes frissítését, és visszaállítja a változáskövetést az objektumkörnyezetben. |
| SaveChanges(Boolean) |
Elavult.
Megőrzi az adatforrás összes frissítését, és opcionálisan visszaállítja a változáskövetést az objektumkörnyezetben. |
| SaveChanges(SaveOptions) |
Az adatforrás minden frissítését megőrzi a megadott SaveOptions. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
| Translate<TElement>(DbDataReader) |
DbDataReader Az entitásadatokat tartalmazó sorokat lefordítja a kért entitástípus objektumaira. |
| Translate<TEntity>(DbDataReader, String, MergeOption) |
DbDataReader Az entitásadatokat tartalmazó sorokat lefordítja a kért entitástípusú objektumokra egy adott entitáskészletben és a megadott egyesítési beállítással. |
| TryGetObjectByKey(EntityKey, Object) |
A megadott entitáskulcsot tartalmazó objektumot ad vissza. |
esemény
| Name | Description |
|---|---|
| ObjectMaterialized |
Akkor fordul elő, ha egy lekérdezési vagy betöltési művelet részeként új entitásobjektum jön létre az adatforrás adataiból. |
| SavingChanges |
A módosítások az adatforrásba való mentésekor fordulnak elő. |