Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ObjectContext-Klasse

.NET Framework 4

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)
C#
C++
F#
VB
Kopieren 
public class ObjectContext : IDisposable

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

  Name Beschreibung
Öffentliche Methode ObjectContext(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 Methode ObjectContext(String) Initialisiert eine neue Instanz der ObjectContext-Klasse mit der angegebenen Verbindungszeichenfolge und dem Standardentitätscontainernamen.
Geschützte Methode ObjectContext(EntityConnection, String) Initialisiert eine neue Instanz der ObjectContext-Klasse mit einer angegebenen Verbindung und einem angegebenen Entitätscontainernamen.
Geschützte Methode ObjectContext(String, String) Initialisiert eine neue Instanz der ObjectContext-Klasse mit einer angegebenen Verbindungszeichenfolge und einem angegebenen Entitätscontainernamen.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft CommandTimeout Ruft 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 Eigenschaft Connection Ruft die vom Objektkontext verwendete Verbindung ab.
Öffentliche Eigenschaft ContextOptions Ruft die ObjectContextOptions-Instanz ab, die Optionen zum Steuern des Verhaltens von ObjectContext enthält.
Öffentliche Eigenschaft DefaultContainerName Ruft den Standardcontainernamen ab oder legt diesen fest.
Öffentliche Eigenschaft MetadataWorkspace Ruft den vom Objektkontext verwendeten Metadaten-Arbeitsbereich ab.
Öffentliche Eigenschaft ObjectStateManager Ruft den Objektstatus-Manager ab, der vom Objektkontext zum Nachverfolgen von Objektänderungen verwendet wird.
Geschützte Eigenschaft QueryProvider Ruft den zugeordneten LINQ-Abfrageanbieter dieses Objektkontexts ab.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode AcceptAllChanges Übernimmt alle Änderungen, die an Objekten im Objektkontext vorgenommen werden.
Öffentliche Methode AddObject Fügt dem Objektkontext ein Objekt hinzu.
Öffentliche Methode ApplyCurrentValues<TEntity> Kopiert die Skalarwerte aus dem angegebenen Objekt in das Objekt im ObjectContext, das über den gleichen Schlüssel verfügt.
Öffentliche Methode ApplyOriginalValues<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 Methode ApplyPropertyChanges Veraltet. Übernimmt Eigenschaftsänderungen eines getrennten Objekts für ein Objekt, das bereits an den Objektkontext angefügt wurde.
Öffentliche Methode Attach Fügt ein Objekt oder Objektdiagramm an den Objektkontext an, wenn das Objekt über einen Entitätsschlüssel verfügt.
Öffentliche Methode AttachTo Fügt ein Objekt oder Objektdiagramm an den Objektkontext in einer bestimmten Entitätenmenge an.
Öffentliche Methode CreateDatabase Erstellt die Datenbank mithilfe der aktuellen Datenquellenverbindung und der Metadaten in der StoreItemCollection.
Öffentliche Methode CreateDatabaseScript Generiert 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 Methode CreateEntityKey Erstellt den Entitätsschlüssel für ein bestimmtes Objekt, oder gibt den Entitätsschlüssel zurück, wenn dieser bereits vorhanden ist.
Öffentliche Methode CreateObject<T> Erstellt eine Instanz des angeforderten Typs und gibt diese zurück.
Öffentliche Methode CreateObjectSet<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 Methode CreateObjectSet<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 Methode CreateProxyTypes Generiert einen gleichwertigen Typ, der mit dem Entity Framework für jeden Typ in der angegebenen Enumeration verwendet werden kann.
Öffentliche Methode CreateQuery<T> Erstellt im aktuellen Objektkontext mit der angegebenen Abfragezeichenfolge ein ObjectQuery<T>.
Öffentliche Methode DatabaseExists Überprüft, ob die als Datenbank in der aktuellen Datenquellenverbindung angegebene Datenbank in der Datenquelle vorhanden ist.
Öffentliche Methode DeleteDatabase Löscht die Datenbank, die in der aktuellen Datenquellenverbindung als Datenbank angegeben ist.
Öffentliche Methode DeleteObject Markiert ein Objekt zum Löschen.
Öffentliche Methode Detach Entfernt das Objekt aus dem Objektkontext.
Öffentliche Methode DetectChanges Stellt sicher, dass ObjectStateEntry-Änderungen mit Änderungen in allen von ObjectStateManager nachverfolgten Objekten synchronisiert werden.
Öffentliche Methode Dispose() Gibt die vom Objektkontext verwendeten Ressourcen frei.
Geschützte Methode Dispose(Boolean) Gibt die vom Objektkontext verwendeten Ressourcen frei.
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Öffentliche Methode ExecuteFunction(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 Methode ExecuteFunction<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 Methode ExecuteFunction<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 Methode ExecuteStoreCommand Führt einen beliebigen Befehl unter Verwendung der vorhandenen Verbindung direkt für die Datenquelle aus.
Öffentliche Methode ExecuteStoreQuery<TElement>(String, Object[]) Führt eine Abfrage, die eine Sequenz typisierter Ergebnisse zurückgibt, direkt für die Datenquelle aus.
Öffentliche Methode ExecuteStoreQuery<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 Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode Statischer Member GetKnownProxyTypes Gibt alle vorhandenen Proxytypen zurück.
Öffentliche Methode GetObjectByKey Gibt ein Objekt mit dem angegebenen Entitätsschlüssel zurück.
Öffentliche Methode Statischer Member GetObjectType Gibt den Entitätstyp der POCO-Entität mit einem Proxyobjekt eines angegebenen Typs zurück.
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode LoadProperty(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 Methode LoadProperty(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 Methode LoadProperty<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 Methode LoadProperty<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 Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Refresh(RefreshMode, IEnumerable) Aktualisiert eine Auflistung von Objekten im Objektkontext mit Daten aus der Datenquelle.
Öffentliche Methode Refresh(RefreshMode, Object) Aktualisiert ein Objekt im Objektkontext mit Daten aus der Datenquelle.
Öffentliche Methode SaveChanges() Speichert alle Aktualisierungen der Datenquelle permanent und setzt die Änderungsnachverfolgung im Objektkontext zurück.
Öffentliche Methode SaveChanges(Boolean) Veraltet. Speichert alle Aktualisierungen der Datenquelle permanent und setzt optional die Änderungsnachverfolgung im Objektkontext zurück.
Öffentliche Methode SaveChanges(SaveOptions) Speichert alle Aktualisierungen der Datenquelle permanent mit dem angegebenen SaveOptions.
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche Methode Translate<TElement>(DbDataReader) Übersetzt ein DbDataReader, das Zeilen mit Entitätsdaten enthält, in Objekte des angeforderten Entitätstyps.
Öffentliche Methode Translate<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 Methode TryGetObjectByKey Gibt ein Objekt mit dem angegebenen Entitätsschlüssel zurück.
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis ObjectMaterialized Tritt auf, wenn im Rahmen einer Abfrage oder eines Ladevorgangs ein neues Entitätsobjekt aus Daten in der Datenquelle erstellt wird.
Öffentliches Ereignis SavingChanges Tritt auf, wenn Änderungen in der Datenquelle gespeichert werden.
Zum Seitenanfang
Hinweis Hinweis

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.

C#
VB
Kopieren 

// 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, 3.5 SP1

.NET Framework Client Profile

Unterstützt in: 4

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.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-Inhalt Hinzufügen
Anmerkungen FAQ