DbContext Classe

Définition

Espace de noms:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v8.0.0

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 d’unité de travail et de dépôt.

public class DbContext : IAsyncDisposable, IDisposable, Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Internal.IDbContextDependencies, Microsoft.EntityFrameworkCore.Internal.IDbContextPoolable, Microsoft.EntityFrameworkCore.Internal.IDbSetCache

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

Implémente

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

Remarques

Entity Framework Core ne prend pas en charge plusieurs opérations parallèles exécutées sur le 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 les 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 thread dbContext .

En règle générale, vous créez une classe qui dérive de DbContext et contient DbSet<TEntity> des 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 le instance du contexte dérivé est créé.

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 plutôt qu’inline dans votre contexte, vous pouvez utiliser DbContextOptionsBuilder<TContext> (ou DbContextOptionsBuilder) pour créer en externe un instance de DbContextOptions<TContext> (ou DbContextOptions) et le passer à un constructeur de base de DbContext.

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 .

Pour plus d’informations et d’exemples , consultez Durée de vie, configuration et initialisation de DbContext, Interrogation de données avec EF Core, Modification du suivi et Enregistrement des données avec EF Core .

Constructeurs

DbContext()	Initialise une nouvelle instance de la classe DbContext. La OnConfiguring(DbContextOptionsBuilder) méthode sera 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

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 pour le contexte instance et le bail de pool, le cas échéant.
Database	Fournit l’accès aux informations et opérations liées à la base de données pour ce contexte.
Model	Métadonnées relatives à la forme des entités, aux 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 à l’initialisation de la base de données.

Méthodes

Add(Object)	Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas encore suivies, dans l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
Add<TEntity>(TEntity)	Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas encore suivies, dans l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
AddAsync(Object, CancellationToken)	Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas encore suivies, dans l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
AddAsync<TEntity>(TEntity, CancellationToken)	Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas encore suivies, dans l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
AddRange(IEnumerable<Object>)	Commence le suivi des entités données et de toutes les autres entités accessibles qui ne sont pas encore suivies, à l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
AddRange(Object[])	Commence le suivi des entités données et de toutes les autres entités accessibles qui ne sont pas encore suivies, à l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas encore suivies, dans l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
AddRangeAsync(Object[])	Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas encore suivies, dans l’état Added de sorte qu’elles soient insérées dans la base de données quand SaveChanges() est appelée.
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 pour 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 pour 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 pour 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 pour les cas où un autre état sera utilisé.
ConfigureConventions(ModelConfigurationBuilder)	Remplacez cette méthode pour définir des 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 un EntityEntry pour l’entité donnée. L’entrée fournit l’accès aux informations et opérations de suivi des modifications pour l’entité.
Entry<TEntity>(TEntity)	Obtient un EntityEntry<TEntity> pour l’entité donnée. L’entrée fournit l’accès 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ées est suivie par le contexte, elle est retournée immédiatement sans demander à la base de données. Sinon, une requête est effectuée sur 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ées est suivie par le contexte, elle est retournée immédiatement sans demander à la base de données. Sinon, une requête est effectuée sur 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ées est suivie par le contexte, elle est retournée immédiatement sans demander à la base de données. Sinon, une requête est effectuée sur 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ées est suivie par le contexte, elle est retournée immédiatement sans demander à la base de données. Sinon, une requête est effectuée sur 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ées est suivie par le contexte, elle est retournée immédiatement sans demander à la base de données. Sinon, une requête est effectuée sur 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ées est suivie par le contexte, elle est retournée immédiatement sans demander à la base de données. Sinon, une requête est effectuée sur 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 un interrogeable 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 qui a été découvert par convention à partir des types d’entités exposés dans DbSet<TEntity> les 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 de sorte qu’elle soit supprimée de la base de données quand SaveChanges() est appelée.
Remove<TEntity>(TEntity)	Commence le suivi de l’entité donnée dans l’état Deleted de sorte qu’elle soit supprimée de la base de données quand SaveChanges() est appelée.
RemoveRange(IEnumerable<Object>)	Commence le suivi de l’entité donnée dans l’état Deleted de sorte qu’elle soit supprimée de la base de données quand SaveChanges() est appelée.
RemoveRange(Object[])	Commence le suivi de l’entité donnée dans l’état Deleted de sorte qu’elle soit supprimée de la base de données quand SaveChanges() est appelée.
SaveChanges()	Enregistre toutes les modifications apportées dans ce contexte dans la base de données.
SaveChanges(Boolean)	Enregistre toutes les modifications apportées dans ce contexte dans la base de données.
SaveChangesAsync(Boolean, CancellationToken)	Enregistre toutes les modifications apportées dans ce contexte dans la base de données.
SaveChangesAsync(CancellationToken)	Enregistre toutes les modifications apportées dans ce contexte dans 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> pour un 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 pour les cas où un autre état est 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 pour les cas où un autre état est 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 pour les cas où un autre état est 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 pour les cas où un autre état est utilisé.

Événements

SaveChangesFailed	Événement déclenché si un appel à SaveChanges ou SaveChangesAsync échoue avec une exception.
SavedChanges	Événement 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

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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et en sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et en sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et en sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et en sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et en sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et en sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 les méthodes d’extension qui doivent utiliser des services qui ne sont pas 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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’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 extrême prudence et sachant que cela peut entraîner des échecs d’application lors de la mise à jour vers une nouvelle version d’Entity Framework Core.

Méthodes d’extension

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 de l’application.
CreateProxy(DbContext, Type, Object[])	Crée un proxy instance pour un type d’entité si la création de proxy a été activée.
CreateProxy<TEntity>(DbContext, Action<TEntity>, Object[])	Crée un proxy instance pour un type d’entité si la création de proxy a été activée.
CreateProxy<TEntity>(DbContext, Object[])	Crée un proxy instance pour un type d’entité si la création de proxy a été activée.