DbContext Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine DbContext-Instanz stellt eine Kombination aus den Mustern "Arbeitseinheit" und "Repository" dar, sodass sie zum Abfragen aus einer Datenbank und zum Gruppieren von Änderungen verwendet werden kann, die dann als Einheit in den Speicher zurückgeschrieben werden. DbContext ist konzeptuell mit ObjectContext vergleichbar.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", Justification="Casing is intentional")]
public class DbContext : IDisposable, System.Data.Entity.Infrastructure.IObjectContextAdapter
public class DbContext : IDisposable, System.Data.Entity.Infrastructure.IObjectContextAdapter
type DbContext = class
interface IDisposable
interface IObjectContextAdapter
Public Class DbContext
Implements IDisposable, IObjectContextAdapter
- Vererbung
-
DbContext
- Abgeleitet
- Attribute
- Implementiert
Hinweise
DbContext wird in der Regel mit einem abgeleiteten Typ verwendet, der Eigenschaften für die Stammentitäten des Modells enthält DbSet<TEntity> . Diese Sätze werden automatisch initialisiert, wenn die Instanz der abgeleiteten Klasse erstellt wird. Dieses Verhalten kann geändert werden, indem das SuppressDbSetInitializationAttribute Attribut entweder auf die gesamte abgeleitete Kontextklasse oder auf einzelne Eigenschaften der Klasse angewendet wird. Das Entitätsdatenmodell, das den Kontext unterstützt, kann auf verschiedene Arten angegeben werden. Bei Verwendung des Code First-Ansatzes werden die DbSet<TEntity> Eigenschaften im abgeleiteten Kontext verwendet, um ein Modell nach Konvention zu erstellen. Die geschützte OnModelCreating-Methode kann überschrieben werden, um dieses Modell zu optimieren. Mehr Kontrolle über das Modell, das für den Ansatz "Modell first" verwendet wird, kann abgerufen werden, indem ein DbCompiledModel explizites Erstellen von einem DbModelBuilder Modell erstellt und an einen der DbContext-Konstruktoren übergeben wird. Bei Verwendung des Datenbank first- oder Model First-Ansatzes kann das Entitätsdatenmodell mithilfe des Entitäts-Designers (oder manuell durch erstellen einer EDMX-Datei) erstellt werden, und dieses Modell kann mithilfe der Entität Verbindungszeichenfolge oder eines EntityConnection Objekts angegeben werden. Die Verbindung mit der Datenbank (einschließlich des Namens der Datenbank) kann auf verschiedene Arten angegeben werden. Wenn der parameterlose DbContext-Konstruktor aus einem abgeleiteten Kontext aufgerufen wird, wird der Name des abgeleiteten Kontexts verwendet, um eine Verbindungszeichenfolge in der datei app.config oder web.config zu finden. Wenn keine Verbindungszeichenfolge gefunden wird, wird der Name an die defaultConnectionFactory übergeben, die für die Database Klasse registriert ist. Die Verbindungsfactory verwendet dann den Kontextnamen als Datenbanknamen in einem Standard-Verbindungszeichenfolge. (Dieser Standardwert Verbindungszeichenfolge verweist auf .\SQLEXPRESS auf dem lokalen Computer, es sei denn, es wird eine andere DefaultConnectionFactory registriert.) Anstatt den abgeleiteten Kontextnamen zu verwenden, kann der Verbindungs-/Datenbankname auch explizit angegeben werden, indem der Name an einen der DbContext-Konstruktoren übergeben wird, die eine Zeichenfolge verwenden. Der Name kann auch im Formular "name=myname" übergeben werden. In diesem Fall muss der Name in der Konfigurationsdatei gefunden werden, oder eine Ausnahme wird ausgelöst. Beachten Sie, dass die in der app.config- oder web.config Datei gefundene Verbindung eine normale Datenbank Verbindungszeichenfolge (nicht ein spezielles Entity Framework Verbindungszeichenfolge) sein kann, in diesem Fall verwendet dbContext Code First. Wenn die in der Konfigurationsdatei gefundene Verbindung jedoch ein spezielles Entity Framework-Verbindungszeichenfolge ist, verwendet dbContext Zuerst Datenbank/Modell, und das in der Verbindungszeichenfolge angegebene Modell wird verwendet. Eine vorhandene oder explizit erstellte DbConnection kann auch anstelle des Datenbank-/Verbindungsnamens verwendet werden. Eine DbModelBuilderVersionAttribute kann auf eine von DbContext abgeleitete Klasse angewendet werden, um die Vom Kontext verwendete Version von Konventionen festzulegen, wenn ein Modell erstellt wird. Wenn kein Attribut angewendet wird, wird die neueste Version der Konventionen verwendet.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DbContext() |
Erstellt eine neue Kontextinstanz mithilfe von Konventionen, um den Namen der Datenbank zu erstellen, mit der eine Verbindung hergestellt wird. Der Nachkonventionsname ist der vollständige Name (Namespace + Klassenname) der abgeleiteten Kontextklasse. In den Klassennotizen erfahren Sie, wie diese zum Erstellen einer Verbindung verwendet wird. |
| DbContext(DbCompiledModel) |
Erstellt eine neue Kontextinstanz mithilfe von Konventionen, um den Namen der Datenbank zu erstellen, mit der eine Verbindung hergestellt wird, und initialisiert sie aus dem angegebenen Modell. Der Nachkonventionsname ist der vollständige Name (Namespace + Klassenname) der abgeleiteten Kontextklasse. In den Klassennotizen erfahren Sie, wie diese zum Erstellen einer Verbindung verwendet wird. |
| DbContext(DbConnection, Boolean) |
Erstellt eine neue Kontextinstanz mithilfe der vorhandenen Verbindung, um eine Verbindung mit einer Datenbank herzustellen.
Die Verbindung wird nicht verworfen, wenn der Kontext verworfen wird. |
| DbContext(DbConnection, DbCompiledModel, Boolean) |
Erstellt eine neue Kontextinstanz mithilfe der vorhandenen Verbindung, um eine Verbindung mit einer Datenbank herzustellen, und initialisiert sie aus dem angegebenen Modell.
Die Verbindung wird nicht verworfen, wenn der Kontext verworfen wird. |
| DbContext(ObjectContext, Boolean) |
Erstellt eine neue Kontextinstanz um einen vorhandenen ObjectContext. |
| DbContext(ObjectContext, Boolean) |
Erstellt eine neue Kontextinstanz um einen vorhandenen ObjectContext. <param name="objectContext">An existing ObjectContext to wrap with the new context.</param param><name="dbContextOwnsObjectContext">If set totrue the ObjectContext is disposed when the DbContext is disposed, otherwise the caller must dispose the connection.</param>
|
| DbContext(String, DbCompiledModel) |
Erstellt eine neue Kontextinstanz mithilfe der angegebenen Zeichenfolge als Name oder Verbindungszeichenfolge für die Datenbank, mit der eine Verbindung hergestellt wird, und initialisiert sie aus dem angegebenen Modell. In den Klassennotizen erfahren Sie, wie diese zum Erstellen einer Verbindung verwendet wird. |
| DbContext(String) |
Erstellt eine neue Kontextinstanz mithilfe der angegebenen Zeichenfolge als Name oder Verbindungszeichenfolge für die Datenbank, mit der eine Verbindung hergestellt wird. In den Klassennotizen erfahren Sie, wie diese zum Erstellen einer Verbindung verwendet wird. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ChangeTracker |
Bietet Zugriff auf Features des Kontexts, der sich mit der Änderungsnachverfolgung von Entitäten befasst. |
| Configuration |
Bietet Zugriff auf Konfigurationsoptionen für den Kontext. |
| Database |
Erstellt eine Datenbankinstanz für diesen Kontext, die erstellungs-/lösch-/existenzprüfungen für die zugrunde liegende Datenbank ermöglicht. |
Methoden
| Name | Beschreibung |
|---|---|
| Dispose() |
Ruft die geschützte Dispose-Methode auf. |
| Dispose(Boolean) |
Entfernt den Kontext. Das zugrunde liegende ObjectContext Element wird auch gelöscht, wenn er von diesem Kontext erstellt wurde oder der Besitz an diesen Kontext übergeben wurde, als dieser Kontext erstellt wurde. Die Verbindung mit der Datenbank (DbConnection Objekt) wird auch gelöscht, wenn sie von diesem Kontext erstellt wurde oder der Besitz an diesen Kontext übergeben wurde, als dieser Kontext erstellt wurde. |
| Entry(Object) |
Ruft ein DbEntityEntry Objekt für die angegebene Entität ab, die Zugriff auf Informationen über die Entität und die Möglichkeit zum Ausführen von Aktionen für die Entität bereitstellt. |
| Entry<TEntity>(TEntity) |
Ruft ein DbEntityEntry<TEntity> Objekt für die angegebene Entität ab, die Zugriff auf Informationen über die Entität und die Möglichkeit zum Ausführen von Aktionen für die Entität bereitstellt. |
| Equals(Object) |
Eine DbContext-Instanz stellt eine Kombination aus den Mustern "Arbeitseinheit" und "Repository" dar, sodass sie zum Abfragen aus einer Datenbank und zum Gruppieren von Änderungen verwendet werden kann, die dann als Einheit in den Speicher zurückgeschrieben werden. DbContext ist konzeptuell mit ObjectContext vergleichbar. |
| GetHashCode() |
Eine DbContext-Instanz stellt eine Kombination aus den Mustern "Arbeitseinheit" und "Repository" dar, sodass sie zum Abfragen aus einer Datenbank und zum Gruppieren von Änderungen verwendet werden kann, die dann als Einheit in den Speicher zurückgeschrieben werden. DbContext ist konzeptuell mit ObjectContext vergleichbar. |
| GetType() |
Eine DbContext-Instanz stellt eine Kombination aus den Mustern "Arbeitseinheit" und "Repository" dar, sodass sie zum Abfragen aus einer Datenbank und zum Gruppieren von Änderungen verwendet werden kann, die dann als Einheit in den Speicher zurückgeschrieben werden. DbContext ist konzeptuell mit ObjectContext vergleichbar. |
| GetValidationErrors() |
Überprüft nachverfolgte Entitäten und gibt eine Sammlung mit DbEntityValidationResult Validierungsergebnissen zurück. |
| OnModelCreating(DbModelBuilder) |
Diese Methode wird aufgerufen, wenn das Modell für einen abgeleiteten Kontext initialisiert wurde, aber bevor das Modell gesperrt und zum Initialisieren des Kontexts verwendet wurde. Die Standardimplementierung dieser Methode führt nichts aus, kann aber in einer abgeleiteten Klasse überschrieben werden, sodass das Modell weiter konfiguriert werden kann, bevor es gesperrt wird. |
| SaveChanges() |
Speichert alle änderungen, die in diesem Kontext an der zugrunde liegenden Datenbank vorgenommen wurden. |
| SaveChangesAsync() |
Speichert asynchron alle änderungen, die in diesem Kontext an der zugrunde liegenden Datenbank vorgenommen wurden. |
| SaveChangesAsync(CancellationToken) |
Speichert asynchron alle änderungen, die in diesem Kontext an der zugrunde liegenden Datenbank vorgenommen wurden. |
| Set(Type) |
Gibt eine nicht generische DbSet Instanz für den Zugriff auf Entitäten des angegebenen Typs im Kontext und im zugrunde liegenden Speicher zurück. |
| Set<TEntity>() |
Gibt eine DbSet<TEntity> Instanz für den Zugriff auf Entitäten des angegebenen Typs im Kontext und im zugrunde liegenden Speicher zurück. |
| ShouldValidateEntity(DbEntityEntry) |
Erweiterungspunkt, der es dem Benutzer ermöglicht, das Standardverhalten der Überprüfung nur hinzugefügter und geänderter Entitäten außer Kraft zu setzen. |
| ToString() |
Eine DbContext-Instanz stellt eine Kombination aus den Mustern "Arbeitseinheit" und "Repository" dar, sodass sie zum Abfragen aus einer Datenbank und zum Gruppieren von Änderungen verwendet werden kann, die dann als Einheit in den Speicher zurückgeschrieben werden. DbContext ist konzeptuell mit ObjectContext vergleichbar. |
| ValidateEntity(DbEntityEntry, IDictionary<Object,Object>) |
Erweiterungspunkt, der es dem Benutzer ermöglicht, die Überprüfung einer Entität anzupassen oder Validierungsergebnisse auszufiltern. Wird von GetValidationErrors() aufgerufen. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IObjectContextAdapter.ObjectContext |
Gibt den Entity Framework ObjectContext zurück, der diesem Kontext zugrunde liegt. |