RelationalOptionsExtension Třída

Definice

Představuje možnosti spravované poskytovateli relačních databází. Tyto možnosti jsou nastaveny pomocí .DbContextOptionsBuilder

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension
Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension
Dědičnost
RelationalOptionsExtension
Implementuje

Poznámky

Instance této třídy jsou navrženy tak, aby byly neměnné. Pokud chcete změnit možnost, zavolejte některou z možností S. metody pro získání nové instance se změněnou možností.

Další informace a příklady najdete v tématu Implementace zprostředkovatelů a rozšíření databáze .

Konstruktory

RelationalOptionsExtension()

Vytvoří novou sadu možností se všemi nastavenými na výchozí hodnoty.

RelationalOptionsExtension(RelationalOptionsExtension)

Volá se konstruktorem odvozené třídy při implementaci Clone() metody.

Vlastnosti

CommandTimeout

Časový limit příkazu nebo null pokud nebyl nastaven žádný.

Connection

, DbConnectionnebo null pokud byl místo úplného objektu připojení použit připojovací řetězec.

ConnectionString

Připojovací řetězec nebo null pokud DbConnection byl použit místo připojovací řetězec.

ExecutionStrategyFactory

Objekt pro vytvoření výchozího IExecutionStrategyobjektu nebo null pokud nebyl nakonfigurován žádný.

Info

Informace nebo metadata o rozšíření.

IsConnectionOwned

true Connection pokud je vlastníkem kontextu a měl by být odpovídajícím způsobem odstraněn.

LogFragment

Vytvoří fragment zprávy pro protokolování, který obvykle obsahuje informace o všech užitečných jiných než výchozích možnostech, které byly nakonfigurovány.

MaxBatchSize

Maximální počet příkazů, které budou zahrnuty v příkazech odesílaných do databáze během SaveChanges() nebo null pokud nebyl žádný nastaven.

MigrationsAssembly

Název sestavení, které obsahuje migrace, nebo null pokud nebyla nastavena žádná.

MigrationsHistoryTableName

Název tabulky, která se má použít pro tabulku historie migrací, nebo null pokud není nastaven žádný.

MigrationsHistoryTableSchema

Schéma, které se má použít pro tabulku historie migrací, nebo null pokud nebylo nastaveno žádné.

MinBatchSize

Minimální počet příkazů, které jsou potřeba pro příkaz s více příkazy odesílané do databáze během SaveChanges() nebo null pokud nebyl žádný nastaven.

QuerySplittingBehavior

Příkaz, QuerySplittingBehavior který se má použít při načítání souvisejících kolekcí v dotazu.

UseRelationalNulls

Určuje, zda se má při porovnávání hodnot null použít sémantika relační databáze. Entity Framework ve výchozím nastavení používá sémantiku jazyka C# pro hodnoty null a vygeneruje SQL, aby vykompenzoval rozdíly ve způsobu zpracování hodnot null v databázi.

Metody

ApplyServices(IServiceCollection)

Přidá služby potřebné k tomu, aby vybrané možnosti fungovaly. Používá se, když neexistuje žádný externí IServiceProvider a EF interně udržuje svého vlastního poskytovatele služeb. To umožňuje poskytovatelům databází (a dalším rozšířením) zaregistrovat požadované služby při vytváření poskytovatele služeb EF.

Clone()

Přepište tuto metodu v odvozené třídě, aby se zajistilo, že každý vytvořený klon je také této třídy.

Extract(IDbContextOptions)

Vyhledá existující RelationalOptionsExtension zaregistrovanou na daných možnostech nebo vyvolá, pokud nebyla zaregistrována žádná. To se obvykle používá k vyhledání nějaké relační konfigurace, pokud je známo, že se používá relační zprostředkovatel.

GetServiceProviderHashCode()

Vrátí kód hash vytvořený z libovolných možností, které by způsobily, že bude potřeba nový IServiceProvider . Většina rozšíření nemá žádné takové možnosti a měla by vracet nulu.

Validate(IDbContextOptions)

Umožňuje rozšíření ověřit, jestli jsou všechny možnosti v rozšíření platné. Většina rozšíření nemá neplatné kombinace, takže se jedná o no-op. Pokud jsou možnosti neplatné, měla by se vyvolat výjimka.

WithCommandTimeout(Nullable<Int32>)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithConnection(DbConnection, Boolean)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithConnection(DbConnection)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithConnectionString(String)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithDefaultWarningConfiguration(CoreOptionsExtension)

Přidá výchozí WarningBehavior hodnotu pro relační události.

WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithMaxBatchSize(Nullable<Int32>)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithMigrationsAssembly(String)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithMigrationsHistoryTableName(String)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithMigrationsHistoryTableSchema(String)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithMinBatchSize(Nullable<Int32>)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithUseQuerySplittingBehavior(QuerySplittingBehavior)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

WithUseRelationalNulls(Boolean)

Vytvoří novou instanci se všemi možnostmi stejnými jako pro tuto instanci, ale se změněnou možností. Je neobvyklé volat tuto metodu přímo. Místo toho použijte DbContextOptionsBuilder.

Platí pro