DbContext Classe

Définition

Espace de noms:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Package:

Microsoft.EntityFrameworkCore v10.0.0

Source:

DbContext.cs

Une instance DbContext représente une session avec la base de données et peut être utilisée pour interroger et enregistrer des instances de vos entités. DbContext est une combinaison des modèles Unit Of Work et Repository.

[System.Runtime.CompilerServices.Nullable(0)]
public class DbContext : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies, Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable, Microsoft.EntityFrameworkCore.Internal.IDbSetCache

[<System.Runtime.CompilerServices.Nullable(0)>]
type DbContext = class
    interface IInfrastructure<IServiceProvider>
    interface IDbContextDependencies
    interface IDbSetCache
    interface IDbContextPoolable
    interface IResettableService
    interface IDisposable
    interface IAsyncDisposable

Public Class DbContext
Implements IAsyncDisposable, IDbContextDependencies, IDbContextPoolable, IDbSetCache, IDisposable, IInfrastructure(Of IServiceProvider)

Héritage

Object

DbContext

Attributs

NullableAttribute

Implémente

IInfrastructure<IServiceProvider> IDisposable IResettableService Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable Microsoft.EntityFrameworkCore.Internal.IDbSetCache IAsyncDisposable

Remarques

Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur la même instance DbContext. Cela inclut l’exécution parallèle de requêtes asynchrones et toute utilisation simultanée explicite de plusieurs threads. Par conséquent, attendez toujours des appels asynchrones immédiatement ou utilisez des instances DbContext distinctes pour les opérations qui s’exécutent en parallèle. Pour plus d’informations et d’exemples, consultez Éviter les problèmes de threading DbContext .

En règle générale, vous créez une classe qui dérive de DbContext et contient des DbSet<TEntity> propriétés pour chaque entité dans le modèle. Si les DbSet<TEntity> propriétés ont un setter public, elles sont automatiquement initialisées lorsque l’instance du contexte dérivé est créée.

Remplacez la OnConfiguring(DbContextOptionsBuilder) méthode pour configurer la base de données (et d’autres options) à utiliser pour le contexte. Sinon, si vous préférez effectuer une configuration en externe au lieu d’inline dans votre contexte, vous pouvez utiliser (ou DbContextOptionsBuilder) pour créer en externe une instance de DbContextOptions<TContext> (ouDbContextOptions) et la transmettre à un constructeur de base de DbContext.DbContextOptionsBuilder<TContext>

Le modèle est découvert en exécutant un ensemble de conventions sur les classes d’entité trouvées dans les DbSet<TEntity> propriétés du contexte dérivé. Pour configurer davantage le modèle découvert par convention, vous pouvez remplacer la OnModelCreating(ModelBuilder) méthode.

Consultez la durée de vie, la configuration et l’initialisation dbContext, interroger des données avec EF Core, modifier le suivi et enregistrer des données avec EF Core pour plus d’informations et d’exemples.

Constructeurs

Nom	Description
DbContext()	Initialise une nouvelle instance de la classe DbContext. La OnConfiguring(DbContextOptionsBuilder) méthode est appelée pour configurer la base de données (et d’autres options) à utiliser pour ce contexte.
DbContext(DbContextOptions)	Initialise une nouvelle instance de la classe à l’aide DbContext des options spécifiées. La OnConfiguring(DbContextOptionsBuilder) méthode sera toujours appelée pour permettre une configuration supplémentaire des options.

Propriétés

Nom	Description
ChangeTracker	Fournit l’accès aux informations et aux opérations pour les instances d’entité que ce contexte effectue le suivi.
ContextId	Identificateur unique de l’instance de contexte et du bail de pool, le cas échéant.
Database	Fournit l’accès aux informations et opérations relatives à la base de données pour ce contexte.
Model	Métadonnées sur la forme des entités, les relations entre elles et la façon dont elles sont mappées à la base de données. Peut ne pas inclure toutes les informations nécessaires pour initialiser la base de données.

Méthodes

Nom	Description
Add(Object)	Commence le suivi de l’entité donnée et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
Add<TEntity>(TEntity)	Commence le suivi de l’entité donnée et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
AddAsync(Object, CancellationToken)	Commence le suivi de l’entité donnée et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
AddAsync<TEntity>(TEntity, CancellationToken)	Commence le suivi de l’entité donnée et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
AddRange(IEnumerable<Object>)	Commence le suivi des entités données et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
AddRange(Object[])	Commence le suivi des entités données et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Commence le suivi de l’entité donnée et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
AddRangeAsync(Object[])	Commence le suivi de l’entité donnée et d’autres entités accessibles qui ne sont pas déjà suivies, dans l’état Added de façon à ce qu’elles soient insérées dans la base de données lorsqu’elles SaveChanges() sont appelées.
Attach(Object)	Commence le suivi de l’entité donnée et des entrées accessibles à partir de l’entité donnée à l’aide de l’état Unchanged par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.
Attach<TEntity>(TEntity)	Commence le suivi de l’entité donnée et des entrées accessibles à partir de l’entité donnée à l’aide de l’état Unchanged par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.
AttachRange(IEnumerable<Object>)	Commence le suivi des entités et entrées données accessibles à partir des entités données à l’aide de l’état Unchanged par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.
AttachRange(Object[])	Commence le suivi des entités et entrées données accessibles à partir des entités données à l’aide de l’état Unchanged par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.
ConfigureConventions(ModelConfigurationBuilder)	Remplacez cette méthode pour définir les valeurs par défaut et configurer des conventions avant leur exécution. Cette méthode est appelée avant OnModelCreating(ModelBuilder).
Dispose()	Libère les ressources allouées pour ce contexte.
DisposeAsync()	Libère les ressources allouées pour ce contexte.
Entry(Object)	Obtient une EntityEntry entité donnée. L’entrée permet d’accéder aux informations et opérations de suivi des modifications pour l’entité.
Entry<TEntity>(TEntity)	Obtient une EntityEntry<TEntity> entité donnée. L’entrée permet d’accéder aux informations et opérations de suivi des modifications pour l’entité.
Find(Type, Object[])	Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire donnée est suivie par le contexte, elle est retournée immédiatement sans effectuer de requête à la base de données. Dans le cas contraire, une requête est effectuée à la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur Null est retournée.
Find<TEntity>(Object[])	Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire donnée est suivie par le contexte, elle est retournée immédiatement sans effectuer de requête à la base de données. Dans le cas contraire, une requête est effectuée à la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur Null est retournée.
FindAsync(Type, Object[], CancellationToken)	Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire donnée est suivie par le contexte, elle est retournée immédiatement sans effectuer de requête à la base de données. Dans le cas contraire, une requête est effectuée à la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur Null est retournée.
FindAsync(Type, Object[])	Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire donnée est suivie par le contexte, elle est retournée immédiatement sans effectuer de requête à la base de données. Dans le cas contraire, une requête est effectuée à la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur Null est retournée.
FindAsync<TEntity>(Object[], CancellationToken)	Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire donnée est suivie par le contexte, elle est retournée immédiatement sans effectuer de requête à la base de données. Dans le cas contraire, une requête est effectuée à la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur Null est retournée.
FindAsync<TEntity>(Object[])	Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire donnée est suivie par le contexte, elle est retournée immédiatement sans effectuer de requête à la base de données. Dans le cas contraire, une requête est effectuée à la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur Null est retournée.
FromExpression<TResult>(Expression<Func<IQueryable<TResult>>>)	Crée une requête pouvant être interrogé pour une expression de requête donnée.
OnConfiguring(DbContextOptionsBuilder)	Remplacez cette méthode pour configurer la base de données (et d’autres options) à utiliser pour ce contexte. Cette méthode est appelée pour chaque instance du contexte créé. L’implémentation de base ne fait rien.
OnModelCreating(ModelBuilder)	Remplacez cette méthode pour configurer davantage le modèle découvert par convention à partir des types d’entités exposés dans les DbSet<TEntity> propriétés de votre contexte dérivé. Le modèle résultant peut être mis en cache et réutilisé pour les instances suivantes de votre contexte dérivé.
Remove(Object)	Commence le suivi de l’entité donnée dans l’état Deleted afin qu’elle soit supprimée de la base de données quand SaveChanges() elle est appelée.
Remove<TEntity>(TEntity)	Commence le suivi de l’entité donnée dans l’état Deleted afin qu’elle soit supprimée de la base de données quand SaveChanges() elle est appelée.
RemoveRange(IEnumerable<Object>)	Commence le suivi de l’entité donnée dans l’état Deleted afin qu’elle soit supprimée de la base de données quand SaveChanges() elle est appelée.
RemoveRange(Object[])	Commence le suivi de l’entité donnée dans l’état Deleted afin qu’elle soit supprimée de la base de données quand SaveChanges() elle est appelée.
SaveChanges()	Enregistre toutes les modifications apportées dans ce contexte à la base de données.
SaveChanges(Boolean)	Enregistre toutes les modifications apportées dans ce contexte à la base de données.
SaveChangesAsync(Boolean, CancellationToken)	Enregistre toutes les modifications apportées dans ce contexte à la base de données.
SaveChangesAsync(CancellationToken)	Enregistre toutes les modifications apportées dans ce contexte à la base de données.
Set<TEntity>()	Crée un DbSet<TEntity> qui peut être utilisé pour interroger et enregistrer des instances de TEntity.
Set<TEntity>(String)	Crée un DbSet<TEntity> type d’entité de type partagé qui peut être utilisé pour interroger et enregistrer des instances de TEntity.
Update(Object)	Commence le suivi de l’entité donnée et des entrées accessibles à partir de l’entité donnée à l’aide de l’état Modified par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.
Update<TEntity>(TEntity)	Commence le suivi de l’entité donnée et des entrées accessibles à partir de l’entité donnée à l’aide de l’état Modified par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.
UpdateRange(IEnumerable<Object>)	Commence le suivi des entités et entrées données accessibles à partir des entités données à l’aide de l’état Modified par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.
UpdateRange(Object[])	Commence le suivi des entités et entrées données accessibles à partir des entités données à l’aide de l’état Modified par défaut, mais voir ci-dessous dans les cas où un autre état sera utilisé.

Événements

Nom	Description
SaveChangesFailed	Événement déclenché en cas d’appel ou SaveChangesSaveChangesAsync d’échec avec une exception.
SavedChanges	Un événement a été déclenché à la fin d’un appel à SaveChanges ou SaveChangesAsync
SavingChanges	Événement déclenché au début d’un appel à SaveChanges ou SaveChangesAsync

Implémentations d’interfaces explicites

Nom	Description
IDbContextDependencies.ChangeDetector	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.EntityFinderFactory	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.EntityGraphAttacher	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.ExceptionDetector	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.InfrastructureLogger	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.QueryProvider	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.SetSource	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.StateManager	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextDependencies.UpdateLogger	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextPoolable.ClearLease()	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextPoolable.SetLease(DbContextLease)	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextPoolable.SetLeaseAsync(DbContextLease, CancellationToken)	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbContextPoolable.SnapshotConfiguration()	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, String, Type)	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, Type)	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IDbSetCache.GetSets()	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IInfrastructure<IServiceProvider>.Instance	Obtient l’étendue IServiceProvider utilisée pour résoudre les services. Cette propriété est destinée à être utilisée par des méthodes d’extension qui doivent utiliser des services non directement exposés dans la surface d’API publique.
IResettableService.ResetState()	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.
IResettableService.ResetStateAsync(CancellationToken)	Il s’agit d’une API interne qui prend en charge l’infrastructure Entity Framework Core et qui n’est pas soumise aux mêmes normes de compatibilité que les API publiques. Il peut être modifié ou supprimé sans préavis dans n’importe quelle version. Vous devez uniquement l’utiliser directement dans votre code avec une prudence extrême et savoir que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version de Entity Framework Core.

Méthodes d’extension

Nom	Description
CreateProxy(DbContext, Type, Object[])	Crée une instance de proxy pour un type d’entité si la création du proxy a été activée.
CreateProxy<TEntity>(DbContext, Action<TEntity>, Object[])	Crée une instance de proxy pour un type d’entité si la création du proxy a été activée.
CreateProxy<TEntity>(DbContext, Object[])	Crée une instance de proxy pour un type d’entité si la création du proxy a été activée.
GetInfrastructure<T>(IInfrastructure<T>)	Obtient la valeur d’une propriété masquée à l’aide IInfrastructure<T>de . Cette méthode est généralement utilisée par les fournisseurs de base de données (et d’autres extensions). Il n’est généralement pas utilisé dans le code d’application.