Partager via


HistoryContext, classe

[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]

Cette classe est utilisée par Migrations Code First pour lire et écrire l'historique des migrations depuis la base de données. Pour personnaliser la définition de la table de l'historique des migrations, vous pouvez dériver de cette classe et remplacer OnModelCreating. Les instances dérivées peuvent être inscrites par configuration des migrations à l'aide de SetHistoryContextFactory(String, Func<DbConnection, String, HistoryContext>), ou globalement à l'aide de SetDefaultHistoryContext(Func<DbConnection, String, HistoryContext>).

Hiérarchie d'héritage

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

Espace de noms :  System.Data.Entity.Migrations.History
Assembly :  EntityFramework (dans EntityFramework.dll)

Syntaxe

'Déclaration
Public Class HistoryContext _
    Inherits DbContext _
    Implements IDbModelCacheKeyProvider
'Utilisation
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

Le type HistoryContext expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique HistoryContext Initialise une nouvelle instance de la classe HistoryContext.Si vous créez un contexte historique dérivé, vous exposez généralement un constructeur qui accepte ces mêmes paramètres et les passe à ce constructeur de base.

Top

Propriétés

  Nom Description
Propriété publique CacheKey Obtient la clé utilisée pour rechercher un modèle qui a été généré pour ce contexte.Cela permet d'éviter de traiter OnModelCreating et de calculer le modèle chaque fois qu'une nouvelle instance de contexte est créée.Par défaut, cette propriété retourne le schéma par défaut.Dans la plupart des cas, vous n'avez pas besoin de remplacer cette propriété.Toutefois, si votre implémentation de OnModelCreating contient une logique conditionnelle qui génère un autre modèle pour les mêmes fournisseur de bases de données et schéma par défaut, vous devez remplacer cette propriété et calculer une clé appropriée.
Propriété publique ChangeTracker Fournit l'accès aux fonctionnalités du contexte relatives au suivi des modifications d'entités. (Hérité de DbContext.)
Propriété publique Configuration Fournit l'accès aux options de configuration pour le contexte. (Hérité de DbContext.)
Propriété publique Database Crée une instance de base de données pour ce contexte et vous permet de créer, supprimer ou vérifier l'existence de la base de données sous-jacente. (Hérité de DbContext.)
Propriété protégée DefaultSchema Obtient le schéma par défaut du modèle migré.Ce schéma est utilisé pour la table de l'historique des migrations, sauf si un schéma différent est configuré dans OnModelCreating.
Propriété publique History Obtient ou définit un DbSet<TEntity> qui peut être utilisé pour lire et écrire les instances HistoryRow.

Top

Méthodes

  Nom Description
Méthode publique Dispose() Appelle la méthode Dispose protégée. (Hérité de DbContext.)
Méthode protégée Dispose(Boolean) Supprime le contexte.Le ObjectContext sous-jacent est également supprimé s'il a été créé par ce contexte ou si la propriété a été passée à ce contexte lorsque ce contexte a été créé.La connexion à la base de données (objet DbConnection ) est également supprimée si elle a été créé par ce contexte ou si la propriété a été passée à ce contexte lorsque ce contexte a été créé. (Hérité de DbContext.)
Méthode publique Entry(Object) Obtient un objet DbEntityEntry pour l'entité spécifique, qui fournit l'accès aux informations sur l'entité et la capacité d'effectuer des actions sur l'entité. (Hérité de DbContext.)
Méthode publique Entry<TEntity>(TEntity) Obtient un objet DbEntityEntry<TEntity> pour l'entité spécifique, qui fournit l'accès aux informations sur l'entité et la capacité d'effectuer des actions sur l'entité. (Hérité de DbContext.)
Méthode publique Equals Détermine si l'objet DbContext spécifié est identique au DbContext actuel. (Hérité de DbContext.)
Méthode protégée Finalize (Hérité de Object.)
Méthode publique GetHashCode Retourne la fonction de hachage pour cet objet DbContext. (Hérité de DbContext.)
Méthode publique GetType Renvoie le type du DbContext actuel. (Hérité de DbContext.)
Méthode publique GetValidationErrors Valide des entités suivies et retourne une collection de DbEntityValidationResult qui contient les résultats de la validation. (Hérité de DbContext.)
Méthode protégée MemberwiseClone (Hérité de Object.)
Méthode protégée OnModelCreating Applique la configuration par défaut pour la table de l'historique des migrations.Si vous remplacez cette méthode, il est recommandé d'appeler cette implémentation de base avant d'appliquer la configuration personnalisée. (Substitue DbContext.OnModelCreating(DbModelBuilder).)
Méthode publique SaveChanges Enregistre toutes les modifications effectuées dans ce contexte dans la base de données sous-jacente. (Hérité de DbContext.)
Méthode publique SaveChangesAsync() Enregistre de façon asynchrone toutes les modifications effectuées dans ce contexte dans la base de données sous-jacente. (Hérité de DbContext.)
Méthode publique SaveChangesAsync(CancellationToken) Enregistre de façon asynchrone toutes les modifications effectuées dans ce contexte dans la base de données sous-jacente. (Hérité de DbContext.)
Méthode publique Set(Type) Retourne une instance DbSet non générique pour l'accès aux entités du type donné dans le contexte et le magasin sous-jacent. (Hérité de DbContext.)
Méthode publique Set<TEntity>() Retourne une instance DbSet<TEntity> pour l'accès aux entités du type donné dans le contexte et le magasin sous-jacent. (Hérité de DbContext.)
Méthode protégée ShouldValidateEntity Point d'extension qui autorise l'utilisateur à substituer le comportement par défaut de la validation des entités ajoutées ou modifiées uniquement. (Hérité de DbContext.)
Méthode publique ToString Retourne sous forme de chaîne de DbContext. (Hérité de DbContext.)
Méthode protégée ValidateEntity Point d'extension qui permet à l'utilisateur de personnaliser la validation d'une entité ou de filtrer les résultats de la validation.Appelée par GetValidationErrors(). (Hérité de DbContext.)

Top

Champs

  Nom Description
Champ publicMembre statique DefaultTableName Nom par défaut utilisé pour la table de l'historique des migrations.

Top

Implémentations d'interface explicite

  Nom Description
Implémentation d'interface explicitePropriété privée IObjectContextAdapter.ObjectContext Retourne l'ObjectContext Entity Framework qui est sous ce contexte. (Hérité de DbContext.)

Top

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms System.Data.Entity.Migrations.History