DbContextOptionsBuilder<TContext> Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje jednoduchou plochu rozhraní API pro konfiguraci DbContextOptions<TContext>. Databáze (a další rozšíření) obvykle definují rozšiřující metody pro tento objekt, které umožňují nakonfigurovat připojení k databázi (a další možnosti) pro použití pro kontext.
public class DbContextOptionsBuilder<TContext> : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder where TContext : DbContexttype DbContextOptionsBuilder<'Context (requires 'Context :> DbContext)> = class
inherit DbContextOptionsBuilderPublic Class DbContextOptionsBuilder(Of TContext)
Inherits DbContextOptionsBuilderParametry typu
- TContext
Typ kontextu, který se má konfigurovat.
- Dědičnost
Poznámky
Můžete použít DbContextOptionsBuilder ke konfiguraci kontextu přepsáním OnConfiguring(DbContextOptionsBuilder) nebo vytvořením DbContextOptions externě a jeho předáním konstruktoru kontextu.
Další informace a příklady najdete v tématu Použití DbContextOptions .
Konstruktory
| DbContextOptionsBuilder<TContext>() |
Inicializuje novou instanci DbContextOptionsBuilder<TContext> třídy bez nastavení možností. |
| DbContextOptionsBuilder<TContext>(DbContextOptions<TContext>) |
Inicializuje novou instanci DbContextOptionsBuilder<TContext> třídy pro další konfiguraci daného DbContextOptionsobjektu . |
Vlastnosti
| IsConfigured |
Získá hodnotu označující, zda byly nakonfigurovány nějaké možnosti. (Zděděno od DbContextOptionsBuilder) |
| Options |
Získá konfigurované možnosti. |
Metody
| AddInterceptors(IEnumerable<IInterceptor>) |
Přidá IInterceptor instance k těm, které jsou registrovány v kontextu. |
| AddInterceptors(IEnumerable<IInterceptor>) |
Přidá IInterceptor instance k těm, které jsou registrovány v kontextu. (Zděděno od DbContextOptionsBuilder) |
| AddInterceptors(IInterceptor[]) |
Přidá IInterceptor instance k těm, které jsou registrovány v kontextu. |
| AddInterceptors(IInterceptor[]) |
Přidá IInterceptor instance k těm, které jsou registrovány v kontextu. (Zděděno od DbContextOptionsBuilder) |
| ConfigureLoggingCacheTime(TimeSpan) |
Konfiguruje, jak dlouho bude EF Core ukládat konfiguraci protokolování do mezipaměti v určitých vysoce výkonných cestách. To způsobí, že EF Core přeskočí potenciálně nákladné kontroly protokolování, ale znamená to, že změny protokolování modulu runtime (např. registrace nového DiagnosticListener nemusí být okamžitě zohledněna). |
| ConfigureLoggingCacheTime(TimeSpan) |
Konfiguruje, jak dlouho bude EF Core ukládat konfiguraci protokolování do mezipaměti v určitých vysoce výkonných cestách. To způsobí, že EF Core přeskočí potenciálně nákladné kontroly protokolování, ale znamená to, že změny protokolování modulu runtime (např. registrace nového DiagnosticListener nemusí být okamžitě zohledněna). (Zděděno od DbContextOptionsBuilder) |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Konfiguruje chování za běhu upozornění vygenerovaných rozhraním Entity Framework. Můžete nastavit výchozí chování a chování pro každý typ upozornění. |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Konfiguruje chování za běhu upozornění vygenerovaných rozhraním Entity Framework. Můžete nastavit výchozí chování a chování pro každý typ upozornění. |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Konfiguruje chování za běhu upozornění vygenerovaných rozhraním Entity Framework. Můžete nastavit výchozí chování a chování pro každý typ upozornění. (Zděděno od DbContextOptionsBuilder) |
| ConfigureWarnings(Action<WarningsConfigurationBuilder>) |
Konfiguruje chování za běhu upozornění vygenerovaných rozhraním Entity Framework. Můžete nastavit výchozí chování a chování pro každý typ upozornění. (Zděděno od DbContextOptionsBuilder) |
| EnableDetailedErrors(Boolean) |
Umožňuje podrobné chyby při zpracování výjimek datových hodnot, ke kterým dochází během zpracování výsledků dotazu na úložiště. K takovým chybám nejčastěji dochází kvůli chybné konfiguraci vlastností entity. Například pokud je vlastnost nakonfigurovaná tak, aby byla typu "int", ale podkladová data v úložišti jsou ve skutečnosti typu "string", pak se během zpracování hodnoty dat vygeneruje výjimka za běhu. Pokud je tato možnost povolená a dojde k chybě dat, vygenerovaná výjimka bude obsahovat podrobnosti o konkrétní vlastnosti entity, která chybu vygenerovala. |
| EnableDetailedErrors(Boolean) |
Umožňuje podrobné chyby při zpracování výjimek datových hodnot, ke kterým dochází během zpracování výsledků dotazu na úložiště. K takovým chybám nejčastěji dochází kvůli chybné konfiguraci vlastností entity. Například pokud je vlastnost nakonfigurovaná tak, aby byla typu "int", ale podkladová data v úložišti jsou ve skutečnosti typu "string", pak se během zpracování hodnoty dat vygeneruje výjimka za běhu. Pokud je tato možnost povolená a dojde k chybě dat, vygenerovaná výjimka bude obsahovat podrobnosti o konkrétní vlastnosti entity, která chybu vygenerovala. (Zděděno od DbContextOptionsBuilder) |
| EnableSensitiveDataLogging() |
Umožňuje zahrnout data aplikací do zpráv o výjimkách, protokolování atd. To může zahrnovat hodnoty přiřazené vlastnostem instancí entit, hodnoty parametrů pro příkazy odesílané do databáze a další taková data. Tento příznak byste měli povolit pouze v případě, že máte na základě citlivosti těchto dat zavedená příslušná bezpečnostní opatření. |
| EnableSensitiveDataLogging() |
Umožňuje zahrnout data aplikací do zpráv o výjimkách, protokolování atd. To může zahrnovat hodnoty přiřazené vlastnostem instancí entit, hodnoty parametrů pro příkazy odesílané do databáze a další taková data. Tento příznak byste měli povolit pouze v případě, že máte na základě citlivosti těchto dat zavedená příslušná bezpečnostní opatření. (Zděděno od DbContextOptionsBuilder) |
| EnableSensitiveDataLogging(Boolean) |
Umožňuje zahrnout data aplikací do zpráv o výjimkách, protokolování atd. To může zahrnovat hodnoty přiřazené vlastnostem instancí entit, hodnoty parametrů pro příkazy odesílané do databáze a další taková data. Tento příznak byste měli povolit pouze v případě, že máte na základě citlivosti těchto dat zavedená příslušná bezpečnostní opatření. |
| EnableSensitiveDataLogging(Boolean) |
Umožňuje zahrnout data aplikací do zpráv o výjimkách, protokolování atd. To může zahrnovat hodnoty přiřazené vlastnostem instancí entit, hodnoty parametrů pro příkazy odesílané do databáze a další taková data. Tento příznak byste měli povolit pouze v případě, že máte na základě citlivosti těchto dat zavedená příslušná bezpečnostní opatření. (Zděděno od DbContextOptionsBuilder) |
| EnableServiceProviderCaching(Boolean) |
Povolí nebo zakáže ukládání interních poskytovatelů služeb do mezipaměti. Zakázání ukládání do mezipaměti může výrazně ovlivnit výkon a mělo by se používat pouze v testovacích scénářích, které vytvářejí mnoho poskytovatelů služeb pro testovací izolaci. |
| EnableServiceProviderCaching(Boolean) |
Povolí nebo zakáže ukládání interních poskytovatelů služeb do mezipaměti. Zakázání ukládání do mezipaměti může výrazně ovlivnit výkon a mělo by se používat pouze v testovacích scénářích, které vytvářejí mnoho poskytovatelů služeb pro testovací izolaci. (Zděděno od DbContextOptionsBuilder) |
| EnableThreadSafetyChecks(Boolean) |
Zakáže detekci souběžnosti, která detekuje mnoho případů chybného souběžného DbContext použití instance a způsobí vyvolání informativní výjimky. To přináší menší zlepšení výkonu, ale pokud DbContext se instance používá souběžně, chování nebude definováno a program může nepředvídatelným způsobem selhat. |
| EnableThreadSafetyChecks(Boolean) |
Zakáže detekci souběžnosti, která detekuje mnoho případů chybného souběžného DbContext použití instance a způsobí vyvolání informativní výjimky. To přináší menší zlepšení výkonu, ale pokud DbContext se instance používá souběžně, chování nebude definováno a program může nepředvídatelným způsobem selhat. (Zděděno od DbContextOptionsBuilder) |
| LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Protokoluje události filtrované zadaným delegátem vlastního filtru. Filtr by měl vrátit hodnotu true, pokud chcete zprávu protokolovat, nebo hodnotu false, pokud ji chcete z protokolu vyfiltrovat. |
| LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>) |
Protokoluje události filtrované zadaným delegátem vlastního filtru. Filtr by měl vrátit hodnotu true, pokud chcete zprávu protokolovat, nebo hodnotu false, pokud ji chcete z protokolu vyfiltrovat. (Zděděno od DbContextOptionsBuilder) |
| LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Protokoluje zadané události pomocí zadané akce. Použijte |
| LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>) |
Protokoluje zadané události pomocí zadané akce. Použijte |
| LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Protokoluje všechny události v zadaných kategoriích pomocí zadané akce. Použijte |
| LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Protokoluje všechny události v zadaných kategoriích pomocí zadané akce. Použijte |
| LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Protokoly používají zadanou akci. Použijte |
| LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>) |
Protokoly používají zadanou akci. Použijte |
| LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Protokoluje události do vlastního delegáta protokolovacího nástroje filtrovaného delegátem vlastního filtru. Filtr by měl vrátit hodnotu true, pokud chcete zprávu protokolovat, nebo hodnotu false, pokud ji chcete z protokolu vyfiltrovat. |
| LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>) |
Protokoluje události do vlastního delegáta protokolovacího nástroje filtrovaného delegátem vlastního filtru. Filtr by měl vrátit hodnotu true, pokud chcete zprávu protokolovat, nebo hodnotu false, pokud ji chcete z protokolu vyfiltrovat. (Zděděno od DbContextOptionsBuilder) |
| ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Nahradí interní implementaci Entity Framework konkrétní implementace kontraktu služby jinou implementací. |
| ReplaceService<TService,TCurrentImplementation,TNewImplementation>() |
Nahradí interní implementaci Entity Framework konkrétní implementace kontraktu služby jinou implementací. (Zděděno od DbContextOptionsBuilder) |
| ReplaceService<TService,TImplementation>() |
Nahradí všechny interní implementace Entity Framework kontraktu služby jinou implementací. |
| ReplaceService<TService,TImplementation>() |
Nahradí všechny interní implementace Entity Framework kontraktu služby jinou implementací. (Zděděno od DbContextOptionsBuilder) |
| UseApplicationServiceProvider(IServiceProvider) |
Nastaví, IServiceProvider ze kterého budou získány aplikační služby. To se provádí automaticky při použití AddDbContext, takže je vzácné, že je potřeba tuto metodu volat. |
| UseApplicationServiceProvider(IServiceProvider) |
Nastaví, IServiceProvider ze kterého budou získány aplikační služby. To se provádí automaticky při použití AddDbContext nebo AddDbContextPool, takže je vzácné, že je potřeba tuto metodu volat. (Zděděno od DbContextOptionsBuilder) |
| UseInternalServiceProvider(IServiceProvider) |
Nastaví, IServiceProvider ze kterého by měl kontext přeložit všechny své služby. EF vytvoří a spravuje poskytovatele služeb, pokud není zadán. |
| UseLoggerFactory(ILoggerFactory) |
Nastaví objekt ILoggerFactory , který se použije k vytvoření ILogger instancí pro protokolování provedeného tímto kontextem. |
| UseMemoryCache(IMemoryCache) |
Nastaví pro IMemoryCache ukládání dotazů do mezipaměti v tomto kontextu. |
| UseModel(IModel) |
Nastaví model, který se má použít pro kontext. Pokud je model nastavený, OnModelCreating(ModelBuilder) pak se nespustí. |
| UseQueryTrackingBehavior(QueryTrackingBehavior) |
Nastaví chování sledování dotazů LINQ spuštěných v kontextu. Zakázání sledování změn je užitečné pro scénáře jen pro čtení, protože se tím vyhnete režii spojenou s nastavením sledování změn pro každou instanci entity. Sledování změn byste neměli zakazovat, pokud chcete manipulovat s instancemi entit a zachovat tyto změny v databázi pomocí SaveChanges(). |
| UseQueryTrackingBehavior(QueryTrackingBehavior) |
Nastaví chování sledování dotazů LINQ spuštěných v kontextu. Zakázání sledování změn je užitečné pro scénáře jen pro čtení, protože se tím vyhnete režii spojenou s nastavením sledování změn pro každou instanci entity. Sledování změn byste neměli zakazovat, pokud chcete manipulovat s instancemi entit a zachovat tyto změny v databázi pomocí SaveChanges(). (Zděděno od DbContextOptionsBuilder) |
| UseRootApplicationServiceProvider() |
Přeloží kořen IServiceProvider z poskytovatele aplikačních služeb s vymezeným oborem. Kořenového zprostředkovatele lze použít k získání jednoúčelových aplikačních služeb z interních služeb. |
| UseRootApplicationServiceProvider() |
Přeloží kořen IServiceProvider z poskytovatele aplikačních služeb s vymezeným oborem. Kořenového zprostředkovatele lze použít k získání jednoúčelových aplikačních služeb z interních služeb. (Zděděno od DbContextOptionsBuilder) |
| UseRootApplicationServiceProvider(IServiceProvider) |
Nastaví kořen IServiceProvider , ze kterého lze získat jednoúčelové aplikační služby z jednoúčelových interních služeb. |
| UseRootApplicationServiceProvider(IServiceProvider) |
Nastaví kořen IServiceProvider , ze kterého lze získat jednoúčelové aplikační služby z jednoúčelových interních služeb. (Zděděno od DbContextOptionsBuilder) |
Explicitní implementace rozhraní
| IDbContextOptionsBuilderInfrastructure.AddOrUpdateExtension<TExtension>(TExtension) |
Přidá dané rozšíření do možností. Pokud už existující rozšíření stejného typu existuje, bude nahrazeno. (Zděděno od DbContextOptionsBuilder) |
Metody rozšíření
Platí pro
Entity Framework