DbContextOptionsBuilder<TContext> Třída

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v8.0.0

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 : DbContext

type DbContextOptionsBuilder<'Context (requires 'Context :> DbContext)> = class
    inherit DbContextOptionsBuilder

Public Class DbContextOptionsBuilder(Of TContext)
Inherits DbContextOptionsBuilder

Parametry typu

TContext

Typ kontextu, který se má konfigurovat.

Dědičnost

Object

DbContextOptionsBuilder

DbContextOptionsBuilder<TContext>

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(IInterceptor[])	Přidá IInterceptor instance k těm, které jsou registrovány v kontextu.
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).
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)
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.
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í.
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.
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.
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>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>)	Protokoluje zadané události pomocí zadané akce. Použijte optionsBuilder.LogTo(Console.WriteLine, new[] { CoreEventId.ContextInitialized }) například k protokolování ContextInitialized události do konzoly nástroje .
LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>)	Protokoluje všechny události v zadaných kategoriích pomocí zadané akce. Použijte optionsBuilder.LogTo(Console.WriteLine, new[] { DbLoggerCategory.Infrastructure.Name }) například k protokolování všech událostí v DbLoggerCategory.Infrastructure kategorii.
LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>)	Protokoly používají zadanou akci. Použijte optionsBuilder.LogTo(Console.WriteLine) například k přihlášení do konzoly nástroje .
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.
ReplaceService<TService,TCurrentImplementation,TNewImplementation>()	Nahradí interní implementaci Entity Framework konkrétní implementace kontraktu služby jinou implementací.
ReplaceService<TService,TImplementation>()	Nahradí všechny interní implementace Entity Framework kontraktu služby jinou implementací.
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.
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().
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(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.

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í

UseCosmos(DbContextOptionsBuilder, String, TokenCredential, String, Action<CosmosDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi Azure Cosmos.
UseCosmos(DbContextOptionsBuilder, String, String, Action<CosmosDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi Azure Cosmos.
UseCosmos(DbContextOptionsBuilder, String, String, String, Action<CosmosDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi Azure Cosmos.
UseCosmos<TContext>(DbContextOptionsBuilder<TContext>, String, TokenCredential, String, Action<CosmosDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi Azure Cosmos.
UseCosmos<TContext>(DbContextOptionsBuilder<TContext>, String, String, Action<CosmosDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi Azure Cosmos.
UseCosmos<TContext>(DbContextOptionsBuilder<TContext>, String, String, String, Action<CosmosDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi Azure Cosmos.
UseInMemoryDatabase(DbContextOptionsBuilder, String, InMemoryDatabaseRoot, Action<InMemoryDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k pojmenované databázi v paměti. Databáze v paměti se sdílí všude, kde se používá stejný název, ale pouze pro daného poskytovatele služeb.
UseInMemoryDatabase(DbContextOptionsBuilder, String, Action<InMemoryDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k pojmenované databázi v paměti. Databáze v paměti se sdílí všude, kde se používá stejný název, ale pouze pro daného poskytovatele služeb. Pokud chcete použít stejnou databázi v paměti mezi poskytovateli služeb, zavolejte UseInMemoryDatabase(DbContextOptionsBuilder, String, InMemoryDatabaseRoot, Action<InMemoryDbContextOptionsBuilder>) předání sdílené InMemoryDatabaseRoot databáze, na které se má databáze rootovat.
UseInMemoryDatabase<TContext>(DbContextOptionsBuilder<TContext>, String, InMemoryDatabaseRoot, Action<InMemoryDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi v paměti. Databáze v paměti se sdílí všude, kde se používá stejný název, ale pouze pro daného poskytovatele služeb.
UseInMemoryDatabase<TContext>(DbContextOptionsBuilder<TContext>, String, Action<InMemoryDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi v paměti. Databáze v paměti se sdílí všude, kde se používá stejný název, ale pouze pro daného poskytovatele služeb. Pokud chcete použít stejnou databázi v paměti mezi poskytovateli služeb, zavolejte UseInMemoryDatabase<TContext>(DbContextOptionsBuilder<TContext>, String, InMemoryDatabaseRoot, Action<InMemoryDbContextOptionsBuilder>) předání sdílené InMemoryDatabaseRoot databáze, na které se má databáze rootovat.
UseChangeTrackingProxies(DbContextOptionsBuilder, Boolean, Boolean)	Zapne vytváření proxy serverů sledování změn.
UseChangeTrackingProxies<TContext>(DbContextOptionsBuilder<TContext>, Boolean, Boolean)	Zapne vytváření proxy serverů sledování změn.
UseLazyLoadingProxies(DbContextOptionsBuilder, Action<LazyLoadingProxiesOptionsBuilder>)	Zapne vytváření opožděných načítání proxy serverů.
UseLazyLoadingProxies(DbContextOptionsBuilder, Boolean)	Zapne vytváření opožděných načítání proxy serverů.
UseLazyLoadingProxies<TContext>(DbContextOptionsBuilder<TContext>, Action<LazyLoadingProxiesOptionsBuilder>)	Zapne vytváření opožděných načítání proxy serverů.
UseLazyLoadingProxies<TContext>(DbContextOptionsBuilder<TContext>, Boolean)	Zapne vytváření opožděných načítání proxy serverů.
UseSqlite(DbContextOptionsBuilder, Action<SqliteDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi SQLite, ale bez počátečního nastavení nebo DbConnection připojovací řetězec.
UseSqlite(DbContextOptionsBuilder, DbConnection, Action<SqliteDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi SQLite.
UseSqlite(DbContextOptionsBuilder, DbConnection, Boolean, Action<SqliteDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi SQLite.
UseSqlite(DbContextOptionsBuilder, String, Action<SqliteDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi SQLite.
UseSqlite<TContext>(DbContextOptionsBuilder<TContext>, Action<SqliteDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi SQLite, ale bez počátečního nastavení nebo DbConnection připojovací řetězec.
UseSqlite<TContext>(DbContextOptionsBuilder<TContext>, DbConnection, Action<SqliteDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi SQLite.
UseSqlite<TContext>(DbContextOptionsBuilder<TContext>, DbConnection, Boolean, Action<SqliteDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi SQLite.
UseSqlite<TContext>(DbContextOptionsBuilder<TContext>, String, Action<SqliteDbContextOptionsBuilder>)	Nakonfiguruje kontext pro připojení k databázi SQLite.
UseSqlServer(DbContextOptionsBuilder, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server, ale bez počátečního nastavení jakékoli DbConnection nebo připojovací řetězec.
UseSqlServer(DbContextOptionsBuilder, DbConnection, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server.
UseSqlServer(DbContextOptionsBuilder, DbConnection, Boolean, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server.
UseSqlServer(DbContextOptionsBuilder, String, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server.
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server, ale bez počátečního nastavení jakékoli DbConnection nebo připojovací řetězec.
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, DbConnection, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server.
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, DbConnection, Boolean, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server.
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, String, Action<SqlServerDbContextOptionsBuilder>)	Konfiguruje kontext pro připojení k databázi Microsoft SQL Server.