DbContext Classe

Definizione

Spazio dei nomi:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacchetto:

Microsoft.EntityFrameworkCore v8.0.0

Un'istanza DbContext rappresenta una sessione con il database e può essere usata per eseguire query e salvare istanze delle entità. DbContext è una combinazione dei modelli Unit Of Work e Repository.

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)

Ereditarietà

Object

DbContext

Implementazioni

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

Commenti

Entity Framework Core non supporta l'esecuzione di più operazioni parallele nella stessa istanza di DbContext. Ciò include sia l'esecuzione parallela di query asincrone che qualsiasi uso simultaneo esplicito da più thread. Pertanto, attendono sempre immediatamente le chiamate asincrone o usano istanze DbContext separate per le operazioni eseguite in parallelo. Per altre informazioni ed esempi, vedere Evitare problemi di threading DbContext .

In genere si crea una classe che deriva da DbContext e contiene DbSet<TEntity> le proprietà per ogni entità nel modello. Se le DbSet<TEntity> proprietà hanno un setter pubblico, vengono inizializzate automaticamente quando viene creata l'istanza del contesto derivato.

Eseguire l'override del OnConfiguring(DbContextOptionsBuilder) metodo per configurare il database (e altre opzioni) da usare per il contesto. In alternativa, se si preferisce eseguire la configurazione esternamente anziché inline nel contesto, è possibile usare (o DbContextOptionsBuilder) per creare esternamente un'istanza di DbContextOptions<TContext> (o DbContextOptions) e passarla a un costruttore di base di DbContext.DbContextOptionsBuilder<TContext>

Il modello viene individuato eseguendo un set di convenzioni sulle classi di entità trovate nelle DbSet<TEntity> proprietà nel contesto derivato. Per configurare ulteriormente il modello individuato per convenzione, è possibile eseguire l'override del OnModelCreating(ModelBuilder) metodo .

Per altre informazioni ed esempi , vedere Durata, configurazione e inizializzazione di DbContext, Esecuzione di query sui dati con EF Core, Rilevamento delle modifiche e Salvataggio dei dati con EF Core .

Costruttori

DbContext()	Inizializza una nuova istanza della classe DbContext. Il OnConfiguring(DbContextOptionsBuilder) metodo verrà chiamato per configurare il database (e altre opzioni) da usare per questo contesto.
DbContext(DbContextOptions)	Inizializza una nuova istanza della DbContext classe usando le opzioni specificate. Il OnConfiguring(DbContextOptionsBuilder) metodo verrà comunque chiamato per consentire un'ulteriore configurazione delle opzioni.

Proprietà

ChangeTracker	Fornisce l'accesso alle informazioni e alle operazioni per le istanze di entità in questo contesto.
ContextId	Identificatore univoco per l'istanza del contesto e il lease del pool, se presente.
Database	Fornisce l'accesso alle informazioni e alle operazioni correlate al database per questo contesto.
Model	Metadati relativi alla forma delle entità, alle relazioni tra di esse e alla modalità di mapping al database. Potrebbe non includere tutte le informazioni necessarie per inizializzare il database.

Metodi

Add(Object)	Inizia a tenere traccia dell'entità specificata e ad altre entità raggiungibili che non sono già monitorate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.
Add<TEntity>(TEntity)	Inizia a tenere traccia dell'entità specificata e ad altre entità raggiungibili che non sono già monitorate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.
AddAsync(Object, CancellationToken)	Inizia a tenere traccia dell'entità specificata e ad altre entità raggiungibili che non sono già monitorate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.
AddAsync<TEntity>(TEntity, CancellationToken)	Inizia a tenere traccia dell'entità specificata e ad altre entità raggiungibili che non sono già monitorate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.
AddRange(IEnumerable<Object>)	Inizia a tenere traccia delle entità indicate e di qualsiasi altra entità raggiungibile che non è già tracciata, nello Added stato in cui verranno inseriti nel database quando SaveChanges() viene chiamato.
AddRange(Object[])	Inizia a tenere traccia delle entità indicate e di qualsiasi altra entità raggiungibile che non è già tracciata, nello Added stato in cui verranno inseriti nel database quando SaveChanges() viene chiamato.
AddRangeAsync(IEnumerable<Object>, CancellationToken)	Inizia a tenere traccia dell'entità specificata e ad altre entità raggiungibili che non sono già monitorate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.
AddRangeAsync(Object[])	Inizia a tenere traccia dell'entità specificata e ad altre entità raggiungibili che non sono già monitorate, nello Added stato in modo che vengano inserite nel database quando SaveChanges() viene chiamato.
Attach(Object)	Inizia a tenere traccia dell'entità e delle voci specificati raggiungibili dall'entità specificata usando lo Unchanged stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.
Attach<TEntity>(TEntity)	Inizia a tenere traccia dell'entità e delle voci specificati raggiungibili dall'entità specificata usando lo Unchanged stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.
AttachRange(IEnumerable<Object>)	Inizia a tenere traccia delle entità e delle voci fornite raggiungibili dalle entità indicate usando lo Unchanged stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.
AttachRange(Object[])	Inizia a tenere traccia delle entità e delle voci fornite raggiungibili dalle entità indicate usando lo Unchanged stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.
ConfigureConventions(ModelConfigurationBuilder)	Eseguire l'override di questo metodo per impostare le convenzioni predefinite e configurare le convenzioni prima dell'esecuzione. Questo metodo viene richiamato prima OnModelCreating(ModelBuilder)di .
Dispose()	Rilascia le risorse allocate per questo contesto.
DisposeAsync()	Rilascia le risorse allocate per questo contesto.
Entry(Object)	Ottiene un EntityEntry oggetto per l'entità specificata. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.
Entry<TEntity>(TEntity)	Ottiene un EntityEntry<TEntity> oggetto per l'entità specificata. La voce fornisce l'accesso alle informazioni e alle operazioni di rilevamento delle modifiche per l'entità.
Find(Type, Object[])	Consente di trovare un'entità con i valori della chiave primaria specificati. Se un'entità con i valori di chiave primaria specificati viene monitorata dal contesto, viene restituita immediatamente senza effettuare una richiesta al database. In caso contrario, viene eseguita una query al database per un'entità con i valori di chiave primaria specificati e questa entità, se trovata, viene associata al contesto e restituita. Se non viene trovata alcuna entità, viene restituito null.
Find<TEntity>(Object[])	Consente di trovare un'entità con i valori della chiave primaria specificati. Se un'entità con i valori di chiave primaria specificati viene monitorata dal contesto, viene restituita immediatamente senza effettuare una richiesta al database. In caso contrario, viene eseguita una query al database per un'entità con i valori di chiave primaria specificati e questa entità, se trovata, viene associata al contesto e restituita. Se non viene trovata alcuna entità, viene restituito null.
FindAsync(Type, Object[], CancellationToken)	Consente di trovare un'entità con i valori della chiave primaria specificati. Se un'entità con i valori di chiave primaria specificati viene monitorata dal contesto, viene restituita immediatamente senza effettuare una richiesta al database. In caso contrario, viene eseguita una query al database per un'entità con i valori di chiave primaria specificati e questa entità, se trovata, viene associata al contesto e restituita. Se non viene trovata alcuna entità, viene restituito null.
FindAsync(Type, Object[])	Consente di trovare un'entità con i valori della chiave primaria specificati. Se un'entità con i valori di chiave primaria specificati viene monitorata dal contesto, viene restituita immediatamente senza effettuare una richiesta al database. In caso contrario, viene eseguita una query al database per un'entità con i valori di chiave primaria specificati e questa entità, se trovata, viene associata al contesto e restituita. Se non viene trovata alcuna entità, viene restituito null.
FindAsync<TEntity>(Object[], CancellationToken)	Consente di trovare un'entità con i valori della chiave primaria specificati. Se un'entità con i valori di chiave primaria specificati viene monitorata dal contesto, viene restituita immediatamente senza effettuare una richiesta al database. In caso contrario, viene eseguita una query al database per un'entità con i valori di chiave primaria specificati e questa entità, se trovata, viene associata al contesto e restituita. Se non viene trovata alcuna entità, viene restituito null.
FindAsync<TEntity>(Object[])	Consente di trovare un'entità con i valori della chiave primaria specificati. Se un'entità con i valori di chiave primaria specificati viene monitorata dal contesto, viene restituita immediatamente senza effettuare una richiesta al database. In caso contrario, viene eseguita una query al database per un'entità con i valori di chiave primaria specificati e questa entità, se trovata, viene associata al contesto e restituita. Se non viene trovata alcuna entità, viene restituito null.
FromExpression<TResult>(Expression<Func<IQueryable<TResult>>>)	Crea una query utilizzabile per un'espressione di query specificata.
OnConfiguring(DbContextOptionsBuilder)	Eseguire l'override di questo metodo per configurare il database (e altre opzioni) da usare per questo contesto. Questo metodo viene chiamato per ogni istanza del contesto creato. L'implementazione di base non esegue alcuna operazione.
OnModelCreating(ModelBuilder)	Eseguire l'override di questo metodo per configurare ulteriormente il modello individuato per convenzione dai tipi di entità esposti nelle DbSet<TEntity> proprietà nel contesto derivato. Il modello risultante può essere memorizzato nella cache e riutilizzato per le istanze successive del contesto derivato.
Remove(Object)	Inizia a tenere traccia dell'entità specificata nello Deleted stato in modo che venga rimossa dal database quando SaveChanges() viene chiamato.
Remove<TEntity>(TEntity)	Inizia a tenere traccia dell'entità specificata nello Deleted stato in modo che venga rimossa dal database quando SaveChanges() viene chiamato.
RemoveRange(IEnumerable<Object>)	Inizia a tenere traccia dell'entità specificata nello Deleted stato in modo che venga rimossa dal database quando SaveChanges() viene chiamato.
RemoveRange(Object[])	Inizia a tenere traccia dell'entità specificata nello Deleted stato in modo che venga rimossa dal database quando SaveChanges() viene chiamato.
SaveChanges()	Salva tutte le modifiche apportate in questo contesto nel database.
SaveChanges(Boolean)	Salva tutte le modifiche apportate in questo contesto nel database.
SaveChangesAsync(Boolean, CancellationToken)	Salva tutte le modifiche apportate in questo contesto nel database.
SaveChangesAsync(CancellationToken)	Salva tutte le modifiche apportate in questo contesto nel database.
Set<TEntity>()	Crea un DbSet<TEntity> oggetto che può essere utilizzato per eseguire query e salvare istanze di TEntity.
Set<TEntity>(String)	Crea un DbSet<TEntity> oggetto per un tipo di entità di tipo condiviso che può essere usato per eseguire query e salvare istanze di TEntity.
Update(Object)	Inizia a tenere traccia dell'entità specificata e delle voci raggiungibili dall'entità specificata usando lo Modified stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.
Update<TEntity>(TEntity)	Inizia a tenere traccia dell'entità specificata e delle voci raggiungibili dall'entità specificata usando lo Modified stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.
UpdateRange(IEnumerable<Object>)	Inizia a tenere traccia delle entità e delle voci fornite raggiungibili dalle entità indicate usando lo Modified stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.
UpdateRange(Object[])	Inizia a tenere traccia delle entità e delle voci fornite raggiungibili dalle entità indicate usando lo Modified stato per impostazione predefinita, ma vedere di seguito per i casi in cui verrà usato uno stato diverso.

Eventi

SaveChangesFailed	Evento generato se una chiamata a SaveChanges o SaveChangesAsync ha esito negativo con un'eccezione.
SavedChanges	Evento generato alla fine di una chiamata a SaveChanges o SaveChangesAsync
SavingChanges	Evento generato all'inizio di una chiamata a SaveChanges o SaveChangesAsync

Implementazioni dell'interfaccia esplicita

IDbContextDependencies.ChangeDetector	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.EntityFinderFactory	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.EntityGraphAttacher	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.ExceptionDetector	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.InfrastructureLogger	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.QueryProvider	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.SetSource	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.StateManager	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextDependencies.UpdateLogger	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextPoolable.ClearLease()	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextPoolable.SetLease(DbContextLease)	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in alcuna versione. È consigliabile usarlo direttamente nel codice con estrema cautela e sapere che questa operazione può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextPoolable.SetLeaseAsync(DbContextLease, CancellationToken)	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in alcuna versione. È consigliabile usarlo direttamente nel codice con estrema cautela e sapere che questa operazione può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbContextPoolable.SnapshotConfiguration()	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in alcuna versione. È consigliabile usarlo direttamente nel codice con estrema cautela e sapere che questa operazione può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, String, Type)	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in alcuna versione. È consigliabile usarlo direttamente nel codice con estrema cautela e sapere che questa operazione può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbSetCache.GetOrAddSet(IDbSetSource, Type)	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in alcuna versione. È consigliabile usarlo direttamente nel codice con estrema cautela e sapere che questa operazione può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IDbSetCache.GetSets()	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in alcuna versione. È consigliabile usarlo direttamente nel codice con estrema cautela e sapere che questa operazione può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IInfrastructure<IServiceProvider>.Instance	Ottiene l'ambito IServiceProvider usato per risolvere i servizi. Questa proprietà è destinata all'uso da parte dei metodi di estensione che devono usare i servizi non esposti direttamente nell'area API pubblica.
IResettableService.ResetState()	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.
IResettableService.ResetStateAsync(CancellationToken)	Si tratta di un'API interna che supporta l'infrastruttura Entity Framework Core e non è soggetta agli stessi standard di compatibilità delle API pubbliche. Può essere modificato o rimosso senza preavviso in nessuna versione. È consigliabile usarlo direttamente nel codice con attenzione estrema e sapere che ciò può causare errori dell'applicazione durante l'aggiornamento a una nuova versione di Entity Framework Core.

Metodi di estensione

GetInfrastructure<T>(IInfrastructure<T>)	Ottiene il valore da una proprietà nascosta tramite IInfrastructure<T>. Questo metodo viene in genere usato dai provider di database (e da altre estensioni). In genere non viene usato nel codice dell'applicazione.
CreateProxy(DbContext, Type, Object[])	Crea un'istanza proxy per un tipo di entità se la creazione del proxy è stata attivata.
CreateProxy<TEntity>(DbContext, Action<TEntity>, Object[])	Crea un'istanza proxy per un tipo di entità se la creazione del proxy è stata attivata.
CreateProxy<TEntity>(DbContext, Object[])	Crea un'istanza proxy per un tipo di entità se la creazione del proxy è stata attivata.