DbContextOptionsBuilder<TContext> Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce una semplice superficie API per la configurazione di DbContextOptions<TContext>. I database (e altre estensioni) definiscono in genere metodi di estensione in questo oggetto che consentono di configurare la connessione al database (e altre opzioni) da usare per un contesto.
public class DbContextOptionsBuilder<TContext> : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder where TContext : DbContexttype DbContextOptionsBuilder<'Context (requires 'Context :> DbContext)> = class
inherit DbContextOptionsBuilderPublic Class DbContextOptionsBuilder(Of TContext)
Inherits DbContextOptionsBuilderParametri di tipo
- TContext
Tipo di contesto da configurare.
- Ereditarietà
Commenti
È possibile usare DbContextOptionsBuilder per configurare un contesto eseguendo l'override OnConfiguring(DbContextOptionsBuilder) o creando un DbContextOptions oggetto esternamente e passandolo al costruttore di contesto.
Per altre informazioni ed esempi, vedere Uso di DbContextOptions .
Costruttori
| DbContextOptionsBuilder<TContext>() |
Inizializza una nuova istanza della DbContextOptionsBuilder<TContext> classe senza opzioni impostate. |
| DbContextOptionsBuilder<TContext>(DbContextOptions<TContext>) |
Inizializza una nuova istanza della DbContextOptionsBuilder<TContext> classe per configurare ulteriormente un determinato DbContextOptionsoggetto . |
Proprietà
| IsConfigured |
Ottiene un valore che indica se sono state configurate le opzioni. (Ereditato da DbContextOptionsBuilder) |
| Options |
Ottiene le opzioni configurate. |
Metodi
| AddInterceptors(IEnumerable<IInterceptor>) |
Aggiunge IInterceptor istanze a quelle registrate nel contesto. |
| AddInterceptors(IEnumerable<IInterceptor>) |
Aggiunge IInterceptor istanze a quelle registrate nel contesto. (Ereditato da DbContextOptionsBuilder) |
| AddInterceptors(IInterceptor[]) |
Aggiunge IInterceptor istanze a quelle registrate nel contesto. |
| AddInterceptors(IInterceptor[]) |
Aggiunge IInterceptor istanze a quelle registrate nel contesto. (Ereditato da DbContextOptionsBuilder) |
| ConfigureLoggingCacheTime(TimeSpan) |
Configura per quanto tempo EF Core memorizza nella cache la configurazione della registrazione in determinati percorsi ad alte prestazioni. Ciò rende ef Core ignorare i controlli di registrazione potenzialmente costosi, ma significa che le modifiche alla registrazione del runtime (ad esempio, la registrazione di un nuovo elemento DiagnosticListener potrebbe non essere presa in considerazione immediatamente). |
| ConfigureLoggingCacheTime(TimeSpan) |
Configura per quanto tempo EF Core memorizza nella cache la configurazione della registrazione in determinati percorsi ad alte prestazioni. Ciò rende ef Core ignorare i controlli di registrazione potenzialmente costosi, ma significa che le modifiche alla registrazione del runtime (ad esempio, la registrazione di un nuovo elemento DiagnosticListener potrebbe non essere presa in considerazione immediatamente). (Ereditato da DbContextOptionsBuilder) |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura il comportamento di runtime degli avvisi generati da Entity Framework. È possibile impostare un comportamento e un comportamento predefiniti per ogni tipo di avviso. |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura il comportamento di runtime degli avvisi generati da Entity Framework. È possibile impostare un comportamento e un comportamento predefiniti per ogni tipo di avviso. |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura il comportamento di runtime degli avvisi generati da Entity Framework. È possibile impostare un comportamento e un comportamento predefiniti per ogni tipo di avviso. (Ereditato da DbContextOptionsBuilder) |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Configura il comportamento di runtime degli avvisi generati da Entity Framework. È possibile impostare un comportamento e un comportamento predefiniti per ogni tipo di avviso. (Ereditato da DbContextOptionsBuilder) |
| EnableDetailedErrors(Boolean) |
Consente errori dettagliati durante la gestione delle eccezioni del valore dei dati che si verificano durante l'elaborazione dei risultati delle query di archiviazione. Tali errori si verificano più spesso a causa di una configurazione errata delle proprietà dell'entità. Ad esempio, se una proprietà è configurata per essere di tipo 'int', ma i dati sottostanti nell'archivio sono effettivamente di tipo 'string', verrà generata un'eccezione in fase di esecuzione durante l'elaborazione del valore dei dati. Quando questa opzione è abilitata e viene rilevato un errore di dati, l'eccezione generata includerà i dettagli della proprietà di entità specifica che ha generato l'errore. |
| EnableDetailedErrors(Boolean) |
Consente errori dettagliati durante la gestione delle eccezioni del valore dei dati che si verificano durante l'elaborazione dei risultati delle query di archiviazione. Tali errori si verificano più spesso a causa di una configurazione errata delle proprietà dell'entità. Ad esempio, se una proprietà è configurata per essere di tipo 'int', ma i dati sottostanti nell'archivio sono effettivamente di tipo 'string', verrà generata un'eccezione in fase di esecuzione durante l'elaborazione del valore dei dati. Quando questa opzione è abilitata e viene rilevato un errore di dati, l'eccezione generata includerà i dettagli della proprietà di entità specifica che ha generato l'errore. (Ereditato da DbContextOptionsBuilder) |
| EnableSensitiveDataLogging() |
Consente di includere i dati dell'applicazione nei messaggi di eccezione, nella registrazione e così via. Ciò può includere i valori assegnati alle proprietà delle istanze dell'entità, i valori dei parametri per i comandi inviati al database e altri dati. È consigliabile abilitare questo flag solo se sono disponibili le misure di sicurezza appropriate in base alla riservatezza dei dati. |
| EnableSensitiveDataLogging() |
Consente di includere i dati dell'applicazione nei messaggi di eccezione, nella registrazione e così via. Ciò può includere i valori assegnati alle proprietà delle istanze dell'entità, i valori dei parametri per i comandi inviati al database e altri dati. È consigliabile abilitare questo flag solo se sono disponibili le misure di sicurezza appropriate in base alla riservatezza dei dati. (Ereditato da DbContextOptionsBuilder) |
| EnableSensitiveDataLogging(Boolean) |
Consente di includere i dati dell'applicazione nei messaggi di eccezione, nella registrazione e così via. Ciò può includere i valori assegnati alle proprietà delle istanze dell'entità, i valori dei parametri per i comandi inviati al database e altri dati. È consigliabile abilitare questo flag solo se sono disponibili le misure di sicurezza appropriate in base alla riservatezza dei dati. |
| EnableSensitiveDataLogging(Boolean) |
Consente di includere i dati dell'applicazione nei messaggi di eccezione, nella registrazione e così via. Ciò può includere i valori assegnati alle proprietà delle istanze dell'entità, i valori dei parametri per i comandi inviati al database e altri dati. È consigliabile abilitare questo flag solo se sono disponibili le misure di sicurezza appropriate in base alla riservatezza dei dati. (Ereditato da DbContextOptionsBuilder) |
| EnableServiceProviderCaching(Boolean) |
Abilita o disabilita la memorizzazione nella cache dei provider di servizi interni. La disabilitazione della memorizzazione nella cache può influire notevolmente sulle prestazioni e deve essere usata solo negli scenari di test che creano molti provider di servizi per l'isolamento dei test. |
| EnableServiceProviderCaching(Boolean) |
Abilita o disabilita la memorizzazione nella cache dei provider di servizi interni. La disabilitazione della memorizzazione nella cache può influire notevolmente sulle prestazioni e deve essere usata solo negli scenari di test che creano molti provider di servizi per l'isolamento dei test. (Ereditato da DbContextOptionsBuilder) |
| EnableThreadSafetyChecks(Boolean) |
Disabilita il rilevamento della concorrenza, che rileva molti casi di utilizzo simultaneo errato di un'istanza DbContext e genera un'eccezione informativa. Ciò fornisce un miglioramento delle prestazioni secondario, ma se un'istanza DbContext viene usata simultaneamente, il comportamento non verrà definito e il programma potrebbe non riuscire in modi imprevedibili. |
| EnableThreadSafetyChecks(Boolean) |
Disabilita il rilevamento della concorrenza, che rileva molti casi di utilizzo simultaneo errato di un'istanza DbContext e genera un'eccezione informativa. Ciò fornisce un miglioramento delle prestazioni secondario, ma se un'istanza DbContext viene usata simultaneamente, il comportamento non verrà definito e il programma potrebbe non riuscire in modi imprevedibili. (Ereditato da DbContextOptionsBuilder) |
| LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Registra gli eventi filtrati da un delegato di filtro personalizzato fornito. Il filtro deve restituire true per registrare un messaggio o false per filtrarlo dal log. |
| LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Registra gli eventi filtrati da un delegato di filtro personalizzato fornito. Il filtro deve restituire true per registrare un messaggio o false per filtrarlo dal log. (Ereditato da DbContextOptionsBuilder) |
| LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra gli eventi specificati usando l'azione specificata. Ad esempio, usare |
| LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra gli eventi specificati usando l'azione specificata. Ad esempio, usare |
| LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra tutti gli eventi nelle categorie specificate usando l'azione fornita. Ad esempio, usare |
| LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Registra tutti gli eventi nelle categorie specificate usando l'azione fornita. Ad esempio, usare |
| LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Log che usano l'azione fornita. Ad esempio, usare |
| LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Log che usano l'azione fornita. Ad esempio, usare |
| LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Registra gli eventi in un delegato del logger personalizzato filtrato da un delegato di filtro personalizzato. Il filtro deve restituire true per registrare un messaggio o false per filtrarlo dal log. |
| LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Registra gli eventi in un delegato del logger personalizzato filtrato da un delegato di filtro personalizzato. Il filtro deve restituire true per registrare un messaggio o false per filtrarlo dal log. (Ereditato da DbContextOptionsBuilder) |
| ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Sostituisce l'implementazione interna di Entity Framework di un'implementazione specifica di un contratto di servizio con un'implementazione diversa. |
| ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Sostituisce l'implementazione interna di Entity Framework di un'implementazione specifica di un contratto di servizio con un'implementazione diversa. (Ereditato da DbContextOptionsBuilder) |
| ReplaceService<TService,TImplementation>() |
Sostituisce tutte le implementazioni interne di Entity Framework di un contratto di servizio con un'implementazione diversa. |
| ReplaceService<TService,TImplementation>() |
Sostituisce tutte le implementazioni interne di Entity Framework di un contratto di servizio con un'implementazione diversa. (Ereditato da DbContextOptionsBuilder) |
| UseApplicationServiceProvider(IServiceProvider) |
Imposta l'oggetto IServiceProvider da cui verranno ottenuti i servizi applicazione. Questa operazione viene eseguita automaticamente quando si usa "AddDbContext", quindi è raro che questo metodo debba essere chiamato. |
| UseApplicationServiceProvider(IServiceProvider) |
Imposta l'oggetto IServiceProvider da cui verranno ottenuti i servizi applicazione. Questa operazione viene eseguita automaticamente quando si usa "AddDbContext" o "AddDbContextPool", quindi è raro che questo metodo debba essere chiamato. (Ereditato da DbContextOptionsBuilder) |
| UseInternalServiceProvider(IServiceProvider) |
Imposta l'oggetto IServiceProvider da cui il contesto deve risolvere tutti i relativi servizi. EF creerà e gestirà un provider di servizi se non è specificato alcun elemento. |
| UseLoggerFactory(ILoggerFactory) |
Imposta l'oggetto ILoggerFactory che verrà usato per creare ILogger istanze per la registrazione eseguita da questo contesto. |
| UseMemoryCache(IMemoryCache) |
Imposta l'oggetto IMemoryCache da utilizzare per la memorizzazione nella cache delle query da questo contesto. |
| UseModel(IModel) |
Imposta il modello da usare per il contesto. Se il modello è impostato, OnModelCreating(ModelBuilder) non verrà eseguito. |
| UseQueryTrackingBehavior(QueryTrackingBehavior) |
Imposta il comportamento di rilevamento per le query LINQ eseguite nel contesto. La disabilitazione del rilevamento delle modifiche è utile per scenari di sola lettura perché evita il sovraccarico della configurazione del rilevamento delle modifiche per ogni istanza di entità. Non è consigliabile disabilitare il rilevamento delle modifiche se si desidera modificare le istanze di entità e rendere persistenti tali modifiche al database usando SaveChanges(). |
| UseQueryTrackingBehavior(QueryTrackingBehavior) |
Imposta il comportamento di rilevamento per le query LINQ eseguite nel contesto. La disabilitazione del rilevamento delle modifiche è utile per scenari di sola lettura perché evita il sovraccarico della configurazione del rilevamento delle modifiche per ogni istanza di entità. Non è consigliabile disabilitare il rilevamento delle modifiche se si desidera modificare le istanze di entità e rendere persistenti tali modifiche al database usando SaveChanges(). (Ereditato da DbContextOptionsBuilder) |
| UseRootApplicationServiceProvider() |
Risolve la radice IServiceProvider dal provider di servizi applicazione con ambito. Il provider radice può essere usato per ottenere servizi applicazione Singleton dai servizi interni singleton. |
| UseRootApplicationServiceProvider() |
Risolve la radice IServiceProvider dal provider di servizi applicazione con ambito. Il provider radice può essere usato per ottenere servizi applicazione Singleton dai servizi interni singleton. (Ereditato da DbContextOptionsBuilder) |
| UseRootApplicationServiceProvider(IServiceProvider) |
Imposta la radice IServiceProvider da cui è possibile ottenere i servizi applicazione singleton dai servizi interni singleton. |
| UseRootApplicationServiceProvider(IServiceProvider) |
Imposta la radice IServiceProvider da cui è possibile ottenere i servizi applicazione singleton dai servizi interni singleton. (Ereditato da DbContextOptionsBuilder) |
Implementazioni dell'interfaccia esplicita
| IDbContextOptionsBuilderInfrastructure.AddOrUpdateExtension<TExtension>(TExtension) |
Aggiunge l'estensione specificata alle opzioni. Se esiste già un'estensione esistente dello stesso tipo, verrà sostituita. (Ereditato da DbContextOptionsBuilder) |
