Freigeben über


HistoryContext-Klasse

[Diese Seite bezieht sich auf Entity Framework Version 6. Die neueste Version ist als 'Entity Framework' NuGet-Paket verfügbar. Weitere Informationen zu Entity Framework finden Sie unter msdn.com/data/ef.]

Diese Klasse wird von Code First-Migrationen verwendet, um den Migrationsverlauf aus der Datenbank zu lesen bzw. in die Datenbank zu schreiben. Zum Anpassen der Definition der Migrationsverlaufstabelle, die Sie aus dieser Klasse ableiten können, und zum Überschreiben von OnModelCreating. Abgeleitete Instanzen können entweder mit SetHistoryContextFactory(String, Func<DbConnection, String, HistoryContext>) auf einer Konfigurationsgrundlage pro Migration oder mit SetDefaultHistoryContext(Func<DbConnection, String, HistoryContext>) global registriert werden.

Vererbungshierarchie

System.Object
  System.Data.Entity.DbContext
    System.Data.Entity.Migrations.History.HistoryContext

Namespace:  System.Data.Entity.Migrations.History
Assembly:  EntityFramework (in EntityFramework.dll)

Syntax

'Declaration
Public Class HistoryContext _
    Inherits DbContext _
    Implements IDbModelCacheKeyProvider
'Usage
Dim instance As HistoryContext
public class HistoryContext : DbContext, 
    IDbModelCacheKeyProvider
public ref class HistoryContext : public DbContext, 
    IDbModelCacheKeyProvider
type HistoryContext =  
    class 
        inherit DbContext 
        interface IDbModelCacheKeyProvider 
    end
public class HistoryContext extends DbContext implements IDbModelCacheKeyProvider

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

Konstruktoren

  Name Beschreibung
Öffentliche Methode HistoryContext Initialisiert eine neue Instanz der HistoryContext-Klasse.Wenn Sie einen abgeleiteten Verlaufskontext erstellen, stellen Sie normalerweise einen Konstruktor zur Verfügung, der dieselben Parameter akzeptiert und sie an diesen Basiskonstruktor weiterleitet.

Oben

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft CacheKey Ruft den Schlüssel ab, der verwendet wird, um ein Modell zu suchen, das zuvor für diesen Kontext erstellt wurde.Dies wird verwendet, um das Verarbeiten von OnModelCreating und das wiederholte Berechnen des Modells zu verhindern, wenn eine neue Kontextinstanz erstellt wird.Standardmäßig gibt diese Eigenschaft das Standardschema zurück.In den meisten Fällen ist es nicht notwendig, diese Eigenschaft zu überschreiben.Wenn Ihre Implementierung von OnModelCreating jedoch Bedingungslogik enthält, die in einem anderen Modell resultiert, das für den gleichen Datenbankanbieter und das gleiche Standardschema erstellt wird, sollten Sie diese Eigenschaft überschreiben und einen geeigneten Schlüssel berechnen.
Öffentliche Eigenschaft ChangeTracker Bietet Zugriff auf Funktionen des Kontexts, die Änderungsnachverfolgung von Entitäten behandeln. (Von DbContext geerbt.)
Öffentliche Eigenschaft Configuration Bietet Zugriff auf Konfigurationsoptionen für den Kontext. (Von DbContext geerbt.)
Öffentliche Eigenschaft Database Erstellt eine Datenbankinstanz für diesen Kontext, die Ihnen ermöglicht, die zugrunde liegende Datenbank auf Erstellung, Löschen oder Vorhandensein zu überprüfen. (Von DbContext geerbt.)
Geschützte Eigenschaft DefaultSchema Ruft das Standardschema des Modells ab, das migriert wird.Dieses Schema wird für die Migrationsverlaufstabelle verwendet, es sei denn, in OnModelCreating wurde ein anderes Schema konfiguriert.
Öffentliche Eigenschaft History Ruft ein DbSet<TEntity> ab oder legt eines fest, das zum Schreiben und Lesen von HistoryRow-Instanzen verwendet werden kann.

Oben

Methoden

  Name Beschreibung
Öffentliche Methode Dispose() Ruft die geschützte Dispose-Methode auf. (Von DbContext geerbt.)
Geschützte Methode Dispose(Boolean) Verwirft den Kontext.Der zugrunde liegende ObjectContext wird auch verworfen, wenn er von diesem Kontext erstellt wurde oder wenn der Besitz beim Erstellen dieses Kontexts an diesen Kontext übergeben wurde.Die Verbindung mit der Datenbank (DbConnection-Objekt) wird auch verworfen, wenn sie von diesem Kontext erstellt wurde oder wenn der Besitz beim Erstellen dieses Kontexts an diesen Kontext übergeben wurde. (Von DbContext geerbt.)
Öffentliche Methode Entry(Object) Ruft ein DbEntityEntry-Objekt für die angegebene Entität ab, um Zugriff auf Informationen zur Entität und die Fähigkeit zum Ausführen von Aktionen für die Entität bereitzustellen. (Von DbContext geerbt.)
Öffentliche Methode Entry<TEntity>(TEntity) Ruft ein DbEntityEntry<TEntity>-Objekt für die angegebene Entität ab, um Zugriff auf Informationen zur Entität und die Fähigkeit zum Ausführen von Aktionen für die Entität bereitzustellen. (Von DbContext geerbt.)
Öffentliche Methode Equals Ermittelt, ob der angegebene DbContext gleich dem aktuellen DbContext ist. (Von DbContext geerbt.)
Geschützte Methode Finalize (Von Object geerbt.)
Öffentliche Methode GetHashCode Gibt die Hashfunktion für diesen DbContext zurück. (Von DbContext geerbt.)
Öffentliche Methode GetType Gibt den Typ des aktuellen DbContext zurück. (Von DbContext geerbt.)
Öffentliche Methode GetValidationErrors Überprüft nachverfolgte Entitäten und gibt eine Auflistung von DbEntityValidationResult zurück, die Validierungsergebnisse enthält. (Von DbContext geerbt.)
Geschützte Methode MemberwiseClone (Von Object geerbt.)
Geschützte Methode OnModelCreating Übernimmt die Standardkonfiguration für die Migrationsverlaufstabelle.Wenn Sie diese Methode überschreiben, wird empfohlen, dass Sie diese Basisimplementierung aufrufen, bevor Sie die benutzerdefinierte Konfiguration anwenden. (Überschreibt DbContext.OnModelCreating(DbModelBuilder).)
Öffentliche Methode SaveChanges Speichert alle in diesem Kontext vorgenommenen Änderungen in der zugrunde liegenden Datenbank. (Von DbContext geerbt.)
Öffentliche Methode SaveChangesAsync() Speichert asynchron alle in diesem Kontext vorgenommenen Änderungen in der zugrunde liegenden Datenbank. (Von DbContext geerbt.)
Öffentliche Methode SaveChangesAsync(CancellationToken) Speichert asynchron alle in diesem Kontext vorgenommenen Änderungen in der zugrunde liegenden Datenbank. (Von DbContext geerbt.)
Öffentliche Methode Set(Type) Gibt eine nicht generische DbSet-Instanz für den Zugriff auf Entitäten des angegebenen Typs im Kontext und den zugrunde liegenden Speicher zurück. (Von DbContext geerbt.)
Öffentliche Methode Set<TEntity>() Gibt eine DbSet<TEntity>-Instanz für den Zugriff auf Entitäten des angegebenen Typs im Kontext und den zugrunde liegenden Speicher zurück. (Von DbContext geerbt.)
Geschützte Methode ShouldValidateEntity Erweiterungspunkt, der es dem Benutzer ermöglicht, das Standardverhalten, mit dem nur Entitäten mit dem Status "Added" und "Modified" überprüft werden, zu überschreiben. (Von DbContext geerbt.)
Öffentliche Methode ToString Gibt die Zeichenfolgendarstellung des DbContext zurück. (Von DbContext geerbt.)
Geschützte Methode ValidateEntity Erweiterungspunkt, der es dem Benutzer ermöglicht, die Validierung einer Entität anzupassen oder Validierungsergebnisse herauszufiltern.Wird von GetValidationErrors() aufgerufen. (Von DbContext geerbt.)

Oben

Felder

  Name Beschreibung
Öffentliches FeldStatischer Member DefaultTableName Der Standardname, der für die Migrationsverlaufstabelle verwendet wird.

Oben

Explizite Schnittstellen implementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Eigenschaft IObjectContextAdapter.ObjectContext Gibt den Entity Framework-ObjectContext zurück, der diesem Kontext zugrunde liegt. (Von DbContext geerbt.)

Oben

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

System.Data.Entity.Migrations.History-Namespace