Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ObjectContext-Klasse

Stellt Funktionen bereit, mit denen Entitätsdaten als Objekte abgefragt und bearbeitet werden können.

System.Object
  System.Data.Objects.ObjectContext

Namespace:  System.Data.Objects
Assembly:  System.Data.Entity (in System.Data.Entity.dll)
public class ObjectContext : IDisposable

Der ObjectContext-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeObjectContext(EntityConnection)Initialisiert eine neue Instanz der ObjectContext-Klasse mit der angegebenen Verbindung. Während der Konstruktion wird der Metadaten-Arbeitsbereich aus dem EntityConnection-Objekt extrahiert.
Öffentliche MethodeObjectContext(String)Initialisiert eine neue Instanz der ObjectContext-Klasse mit der angegebenen Verbindungszeichenfolge und dem Standardentitätscontainernamen.
Geschützte MethodeObjectContext(EntityConnection, String)Initialisiert eine neue Instanz der ObjectContext-Klasse mit einer angegebenen Verbindung und einem angegebenen Entitätscontainernamen.
Geschützte MethodeObjectContext(String, String)Initialisiert eine neue Instanz der ObjectContext-Klasse mit einer angegebenen Verbindungszeichenfolge und einem angegebenen Entitätscontainernamen.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftCommandTimeoutRuft den Timeoutwert in Sekunden für alle Vorgänge im Objektkontext ab oder legt ihn fest. Der Wert null gibt an, dass der Standardwert des zugrunde liegenden Anbieters verwendet wird.
Öffentliche EigenschaftConnectionRuft die vom Objektkontext verwendete Verbindung ab.
Öffentliche EigenschaftContextOptionsRuft die ObjectContextOptions-Instanz ab, die Optionen zum Steuern des Verhaltens von ObjectContext enthält.
Öffentliche EigenschaftDefaultContainerNameRuft den Standardcontainernamen ab oder legt diesen fest.
Öffentliche EigenschaftMetadataWorkspaceRuft den vom Objektkontext verwendeten Metadaten-Arbeitsbereich ab.
Öffentliche EigenschaftObjectStateManagerRuft den Objektstatus-Manager ab, der vom Objektkontext zum Nachverfolgen von Objektänderungen verwendet wird.
Geschützte EigenschaftQueryProviderRuft den zugeordneten LINQ-Abfrageanbieter dieses Objektkontexts ab.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeAcceptAllChangesÜbernimmt alle Änderungen, die an Objekten im Objektkontext vorgenommen werden.
Öffentliche MethodeAddObjectFügt dem Objektkontext ein Objekt hinzu.
Öffentliche MethodeApplyCurrentValues<TEntity>Kopiert die Skalarwerte aus dem angegebenen Objekt in das Objekt im ObjectContext, das über den gleichen Schlüssel verfügt.
Öffentliche MethodeApplyOriginalValues<TEntity>Kopiert die Skalarwerte aus dem angegebenen Objekt in den Satz von ursprünglichen Werten für das Objekt im ObjectContext, das über den gleichen Schlüssel verfügt.
Öffentliche MethodeApplyPropertyChanges Veraltet. Übernimmt Eigenschaftsänderungen eines getrennten Objekts für ein Objekt, das bereits an den Objektkontext angefügt wurde.
Öffentliche MethodeAttachFügt ein Objekt oder Objektdiagramm an den Objektkontext an, wenn das Objekt über einen Entitätsschlüssel verfügt.
Öffentliche MethodeAttachToFügt ein Objekt oder Objektdiagramm an den Objektkontext in einer bestimmten Entitätenmenge an.
Öffentliche MethodeCreateDatabaseErstellt die Datenbank mithilfe der aktuellen Datenquellenverbindung und der Metadaten in der StoreItemCollection.
Öffentliche MethodeCreateDatabaseScriptGeneriert ein DDL (Data Definition Language)-Skript, das Schemaobjekte (Tabellen, Primärschlüssel, Fremdschlüssel) für die Metadaten in der StoreItemCollection erstellt. StoreItemCollection lädt Metadaten aus SSDL (Datenspeicherschema-Definitionssprache)-Dateien.
Öffentliche MethodeCreateEntityKeyErstellt den Entitätsschlüssel für ein bestimmtes Objekt, oder gibt den Entitätsschlüssel zurück, wenn dieser bereits vorhanden ist.
Öffentliche MethodeCreateObject<T>Erstellt eine Instanz des angeforderten Typs und gibt diese zurück.
Öffentliche MethodeCreateObjectSet<TEntity>()Erstellt eine neue ObjectSet<TEntity>-Instanz, die verwendet wird, um Objekte des angegebenen Entitätstyps abzufragen, hinzuzufügen, zu ändern und zu löschen.
Öffentliche MethodeCreateObjectSet<TEntity>(String)Erstellt eine neue ObjectSet<TEntity>-Instanz, die verwendet wird, um Objekte des angegebenen Typs mit dem angegebenen Entitätenmengennamen abzufragen, hinzuzufügen, zu ändern und zu löschen.
Öffentliche MethodeCreateProxyTypesGeneriert einen gleichwertigen Typ, der mit dem Entity Framework für jeden Typ in der angegebenen Enumeration verwendet werden kann.
Öffentliche MethodeCreateQuery<T>Erstellt im aktuellen Objektkontext mit der angegebenen Abfragezeichenfolge ein ObjectQuery<T>.
Öffentliche MethodeDatabaseExistsÜberprüft, ob die als Datenbank in der aktuellen Datenquellenverbindung angegebene Datenbank in der Datenquelle vorhanden ist.
Öffentliche MethodeDeleteDatabaseLöscht die Datenbank, die in der aktuellen Datenquellenverbindung als Datenbank angegeben ist.
Öffentliche MethodeDeleteObjectMarkiert ein Objekt zum Löschen.
Öffentliche MethodeDetachEntfernt das Objekt aus dem Objektkontext.
Öffentliche MethodeDetectChangesStellt sicher, dass ObjectStateEntry-Änderungen mit Änderungen in allen von ObjectStateManager nachverfolgten Objekten synchronisiert werden.
Öffentliche MethodeDispose()Gibt die vom Objektkontext verwendeten Ressourcen frei.
Geschützte MethodeDispose(Boolean)Gibt die vom Objektkontext verwendeten Ressourcen frei.
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Öffentliche MethodeExecuteFunction(String, ObjectParameter[])Führt eine gespeicherte Prozedur oder eine Funktion aus, die in der Datenquelle definiert ist und im konzeptionellen Modell ausgedrückt wird, verwirft alle von der Funktion zurückgegebenen Ergebnisse, und gibt die von der Ausführung betroffene Anzahl von Zeilen zurück.
Öffentliche MethodeExecuteFunction<TElement>(String, ObjectParameter[])Führt eine gespeicherte Prozedur oder eine Funktion, die in der Datenquelle definiert ist und im konzeptionellen Modell zugeordnet wird, mit den angegebenen Parametern aus. Gibt ein typisiertes ObjectResult<T> zurück.
Öffentliche MethodeExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])Führt die angegebene gespeicherte Prozedur oder Funktion, die in der Datenquelle definiert ist und im konzeptionellen Modell ausgedrückt wird, mit den angegebenen Parametern und der angegebenen Zusammenführungsoption aus. Gibt ein typisiertes ObjectResult<T> zurück.
Öffentliche MethodeExecuteStoreCommandFührt einen beliebigen Befehl unter Verwendung der vorhandenen Verbindung direkt für die Datenquelle aus.
Öffentliche MethodeExecuteStoreQuery<TElement>(String, Object[])Führt eine Abfrage, die eine Sequenz typisierter Ergebnisse zurückgibt, direkt für die Datenquelle aus.
Öffentliche MethodeExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])Führt eine Abfrage, die eine Sequenz typisierter Ergebnisse zurückgibt, direkt für die Datenquelle aus. Geben Sie die Entitätenmenge und die Zusammenführungsoption an, damit Abfrageergebnisse als Entitäten nachverfolgt werden können.
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetHashCodeFungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche MethodeStatischer MemberGetKnownProxyTypesGibt alle vorhandenen Proxytypen zurück.
Öffentliche MethodeGetObjectByKeyGibt ein Objekt mit dem angegebenen Entitätsschlüssel zurück.
Öffentliche MethodeStatischer MemberGetObjectTypeGibt den Entitätstyp der POCO-Entität mit einem Proxyobjekt eines angegebenen Typs zurück.
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeLoadProperty(Object, String)Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen Navigationseigenschaft und unter Verwendung der standardmäßigen Zusammenführungsoption.
Öffentliche MethodeLoadProperty(Object, String, MergeOption)Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen Navigationseigenschaft und unter Verwendung der angegebenen Zusammenführungsoption.
Öffentliche MethodeLoadProperty<TEntity>(TEntity, Expression<Func<TEntity, Object>>)Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen LINQ-Abfrage und unter Verwendung der standardmäßigen Zusammenführungsoption.
Öffentliche MethodeLoadProperty<TEntity>(TEntity, Expression<Func<TEntity, Object>>, MergeOption)Lädt ein mit dem angegebenen Objekt verbundenes Objekt explizit anhand der angegebenen LINQ-Abfrage und unter Verwendung der angegebenen Zusammenführungsoption.
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeRefresh(RefreshMode, IEnumerable)Aktualisiert eine Auflistung von Objekten im Objektkontext mit Daten aus der Datenquelle.
Öffentliche MethodeRefresh(RefreshMode, Object)Aktualisiert ein Objekt im Objektkontext mit Daten aus der Datenquelle.
Öffentliche MethodeSaveChanges()Speichert alle Aktualisierungen der Datenquelle permanent und setzt die Änderungsnachverfolgung im Objektkontext zurück.
Öffentliche MethodeSaveChanges(Boolean) Veraltet. Speichert alle Aktualisierungen der Datenquelle permanent und setzt optional die Änderungsnachverfolgung im Objektkontext zurück.
Öffentliche MethodeSaveChanges(SaveOptions)Speichert alle Aktualisierungen der Datenquelle permanent mit dem angegebenen SaveOptions.
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche MethodeTranslate<TElement>(DbDataReader)Übersetzt einen DbDataReader, der Zeilen mit Entitätsdaten enthält, in Objekte des angeforderten Entitätstyps.
Öffentliche MethodeTranslate<TEntity>(DbDataReader, String, MergeOption)Übersetzt ein DbDataReader, das Zeilen mit Entitätsdaten enthält, in einer bestimmten Entitätenmenge und mit der angegebenen Zusammenführungsoption in Objekte des angeforderten Entitätstyps.
Öffentliche MethodeTryGetObjectByKeyGibt ein Objekt mit dem angegebenen Entitätsschlüssel zurück.
Zum Seitenanfang
  NameBeschreibung
Öffentliches EreignisObjectMaterializedTritt auf, wenn im Rahmen einer Abfrage oder eines Ladevorgangs ein neues Entitätsobjekt aus Daten in der Datenquelle erstellt wird.
Öffentliches EreignisSavingChangesTritt auf, wenn Änderungen in der Datenquelle gespeichert werden.
Zum Seitenanfang
HinweisHinweis

Die ObjectContext-Klasse ist nicht threadsicher. Die Integrität von Datenobjekten in einem ObjectContext kann nicht in Multithreadszenarien sichergestellt werden.

Bei der ObjectContext-Klasse handelt es sich um die primäre Klasse für die Interaktion mit Daten als Objekte, die Instanzen von in einem konzeptionellen Modell definierten Entitätstypen sind. Eine Instanz der ObjectContext-Klasse kapselt Folgendes:

Wenn die Objektebene, die ein konzeptionelles Modell darstellt, von den Entity Data Model-Tools generiert wird, wird die Klasse, die das EntityContainer-Element für das Modell darstellt, vom ObjectContext abgeleitet.

Dieses Beispiel beruht auf dem Adventure Works Sales Model. Das folgende Beispiel zeigt die Vorgehensweise beim Erstellen eines 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);


.NET Framework

Unterstützt in: 4.5, 4, 3.5 SP1

.NET Framework Client Profile

Unterstützt in: 4

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.