ObjectContext Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.Objects

Zestaw:: System.Data.Entity.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Udostępnia obiekty do wykonywania zapytań i pracy z danymi jednostki jako obiektów.

public ref class ObjectContext : IDisposable

public class ObjectContext : IDisposable

type ObjectContext = class
    interface IDisposable

Public Class ObjectContext
Implements IDisposable

Dziedziczenie: Object
ObjectContext

Implementuje: IDisposable

Przykłady

W tym przykładzie pokazano, jak utworzyć element 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);

Uwagi

Uwaga

Klasa ObjectContext nie jest bezpieczna wątkiem. Integralność obiektów danych w scenariuszach ObjectContext wielowątkowych nie może być zapewniona.

Klasa ObjectContext jest klasą podstawową do interakcji z danymi jako obiektów, które są wystąpieniami typów jednostek zdefiniowanych w modelu koncepcyjnym. Wystąpienie ObjectContext klasy hermetyzuje następujące elementy:

Połączenie z bazą EntityConnection danych w postaci obiektu.
Metadane opisujące model w postaci MetadataWorkspace obiektu.
ObjectStateManager Obiekt, który zarządza obiektami utrwalone w pamięci podręcznej.

Gdy warstwa obiektu reprezentująca model koncepcyjny jest generowana przez narzędzia Entity Data Model, klasa reprezentująca EntityContainer model dla modelu pochodzi z ObjectContextklasy .

Konstruktory

ObjectContext(EntityConnection)	Inicjuje ObjectContext nowe wystąpienie klasy z danym połączeniem. Podczas budowy obszar roboczy metadanych jest wyodrębniany z EntityConnection obiektu.
ObjectContext(EntityConnection, String)	Inicjuje ObjectContext nowe wystąpienie klasy z daną nazwą połączenia i kontenera jednostki.
ObjectContext(String)	Inicjuje ObjectContext nowe wystąpienie klasy przy użyciu podanej parametry połączenia i domyślnej nazwy kontenera jednostek.
ObjectContext(String, String)	Inicjuje ObjectContext nowe wystąpienie klasy o podanej nazwie kontenera parametry połączenia i jednostce.

Właściwości

CommandTimeout	Pobiera lub ustawia wartość limitu czasu w sekundach dla wszystkich operacji kontekstu obiektu. Wartość `null` wskazuje, że zostanie użyta domyślna wartość bazowego dostawcy.
Connection	Pobiera połączenie używane przez kontekst obiektu.
ContextOptions	ObjectContextOptions Pobiera wystąpienie zawierające opcje wpływające na zachowanie obiektu ObjectContext.
DefaultContainerName	Pobiera lub ustawia domyślną nazwę kontenera.
MetadataWorkspace	Pobiera obszar roboczy metadanych używany przez kontekst obiektu.
ObjectStateManager	Pobiera menedżera stanu obiektu używanego przez kontekst obiektu do śledzenia zmian obiektów.
QueryProvider	Pobiera dostawcę zapytań LINQ skojarzonego z tym kontekstem obiektu.

Metody

AcceptAllChanges()	Akceptuje wszystkie zmiany wprowadzone w obiektach w kontekście obiektu.
AddObject(String, Object)	Dodaje obiekt do kontekstu obiektu.
ApplyCurrentValues<TEntity>(String, TEntity)	Kopiuje wartości skalarne z dostarczonego obiektu do obiektu w obiekcie, ObjectContext który ma ten sam klucz.
ApplyOriginalValues<TEntity>(String, TEntity)	Kopiuje wartości skalarne z dostarczonego obiektu do zestawu oryginalnych wartości dla obiektu w tym samym kluczu ObjectContext .
ApplyPropertyChanges(String, Object)	Przestarzałe. Stosuje zmiany właściwości z odłączonego obiektu do obiektu już dołączonego do kontekstu obiektu.
Attach(IEntityWithKey)	Dołącza wykres obiektu lub obiektu do kontekstu obiektu, gdy obiekt ma klucz jednostki.
AttachTo(String, Object)	Dołącza wykres obiektu lub obiektu do kontekstu obiektu w określonym zestawie jednostek.
CreateDatabase()	Tworzy bazę danych przy użyciu bieżącego połączenia źródła danych i metadanych w elemencie StoreItemCollection.
CreateDatabaseScript()	Generuje skrypt języka definicji danych (DDL), który tworzy obiekty schematu (tabele, klucze podstawowe, klucze obce) dla metadanych w obiekcie StoreItemCollection. Ładuje StoreItemCollection metadane z plików języka definicji schematu (SSDL).
CreateEntityKey(String, Object)	Tworzy klucz jednostki dla określonego obiektu lub zwraca klucz jednostki, jeśli już istnieje.
CreateObject<T>()	Tworzy i zwraca wystąpienie żądanego typu .
CreateObjectSet<TEntity>()	Tworzy nowe ObjectSet<TEntity> wystąpienie używane do wykonywania zapytań, dodawania, modyfikowania i usuwania obiektów określonego typu jednostki.
CreateObjectSet<TEntity>(String)	Tworzy nowe ObjectSet<TEntity> wystąpienie używane do wykonywania zapytań, dodawania, modyfikowania i usuwania obiektów określonego typu oraz o określonej nazwie zestawu jednostek.
CreateProxyTypes(IEnumerable<Type>)	Generuje równoważny typ, który może być używany z platformą Entity Framework dla każdego typu podanego wyliczenia.
CreateQuery<T>(String, ObjectParameter[])	Tworzy element ObjectQuery<T> w bieżącym kontekście obiektu przy użyciu określonego ciągu zapytania.
DatabaseExists()	Sprawdza, czy baza danych określona jako baza danych w bieżącym połączeniu źródła danych istnieje w źródle danych.
DeleteDatabase()	Usuwa bazę danych, która jest określona jako baza danych w bieżącym połączeniu źródła danych.
DeleteObject(Object)	Oznacza obiekt do usunięcia.
Detach(Object)	Usuwa obiekt z kontekstu obiektu.
DetectChanges()	Gwarantuje, że ObjectStateEntry zmiany są synchronizowane ze zmianami we wszystkich obiektach śledzonych przez ObjectStateManagerobiekt .
Dispose()	Zwalnia zasoby używane przez kontekst obiektu.
Dispose(Boolean)	Zwalnia zasoby używane przez kontekst obiektu.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExecuteFunction(String, ObjectParameter[])	Wykonuje procedurę składowaną lub funkcję zdefiniowaną w źródle danych i wyrażoną w modelu koncepcyjnym; odrzuca wszystkie wyniki zwrócone z funkcji; i zwraca liczbę wierszy, których dotyczy wykonanie.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	Wykonuje daną procedurę składowaną lub funkcję zdefiniowaną w źródle danych i wyrażoną w modelu koncepcyjnym z określonymi parametrami i opcją scalania. Zwraca typizowane ObjectResult<T>polecenie .
ExecuteFunction<TElement>(String, ObjectParameter[])	Wykonuje procedurę składowaną lub funkcję zdefiniowaną w źródle danych i zamapowaną w modelu koncepcyjnym z określonymi parametrami. Zwraca typizowane ObjectResult<T>polecenie .
ExecuteStoreCommand(String, Object[])	Wykonuje dowolne polecenie bezpośrednio względem źródła danych przy użyciu istniejącego połączenia.
ExecuteStoreQuery<TElement>(String, Object[])	Wykonuje zapytanie bezpośrednio względem źródła danych, które zwraca sekwencję typowanych wyników.
ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])	Wykonuje zapytanie bezpośrednio względem źródła danych i zwraca sekwencję typowanych wyników. Określ zestaw jednostek i opcję scalania, aby wyniki zapytania mogły być śledzone jako jednostki.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetKnownProxyTypes()	Zwraca wszystkie istniejące typy serwerów proxy.
GetObjectByKey(EntityKey)	Zwraca obiekt, który ma określony klucz jednostki.
GetObjectType(Type)	Zwraca typ jednostki POCO skojarzony z obiektem proxy określonego typu.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
LoadProperty(Object, String)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określoną właściwość nawigacji i użyj domyślnej opcji scalania.
LoadProperty(Object, String, MergeOption)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określoną właściwość nawigacji i przy użyciu określonej opcji scalania.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określone zapytanie LINQ i przy użyciu domyślnej opcji scalania.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Jawnie ładuje obiekt powiązany z podanym obiektem przez określone zapytanie LINQ i przy użyciu określonej opcji scalania.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Refresh(RefreshMode, IEnumerable)	Aktualizacje kolekcję obiektów w kontekście obiektu z danymi ze źródła danych.
Refresh(RefreshMode, Object)	Aktualizacje obiekt w kontekście obiektu z danymi ze źródła danych.
SaveChanges()	Utrwala wszystkie aktualizacje źródła danych i resetuje śledzenie zmian w kontekście obiektu.
SaveChanges(Boolean)	Przestarzałe. Utrwala wszystkie aktualizacje źródła danych i opcjonalnie resetuje śledzenie zmian w kontekście obiektu.
SaveChanges(SaveOptions)	Utrwala wszystkie aktualizacje źródła danych przy użyciu określonego SaveOptionselementu .
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Translate<TElement>(DbDataReader)	DbDataReader Tłumaczy element zawierający wiersze danych jednostki do obiektów żądanego typu jednostki.
Translate<TEntity>(DbDataReader, String, MergeOption)	DbDataReader Tłumaczy wiersze danych jednostki na obiekty żądanego typu jednostki, w określonym zestawie jednostek i z określoną opcją scalania.
TryGetObjectByKey(EntityKey, Object)	Zwraca obiekt, który ma określony klucz jednostki.

Zdarzenia

ObjectMaterialized	Występuje, gdy nowy obiekt jednostki jest tworzony na podstawie danych w źródle danych w ramach operacji zapytania lub ładowania.
SavingChanges	Występuje, gdy zmiany są zapisywane w źródle danych.

Dotyczy