RelationalOptionsExtension Klasa

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje opcje zarządzane przez dostawców relacyjnej bazy danych. Te opcje są ustawiane przy użyciu polecenia DbContextOptionsBuilder.

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension

[System.Runtime.CompilerServices.Nullable(0)]
public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension

type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension

[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension

Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension

Dziedziczenie: Object
RelationalOptionsExtension

Atrybuty: NullableAttribute

Implementuje: IDbContextOptionsExtension

Uwagi

Wystąpienia tej klasy są przeznaczone do niezmienności. Aby zmienić opcję, wywołaj jedną z opcji "With..." metody uzyskiwania nowego wystąpienia ze zmienioną opcją.

Aby uzyskać więcej informacji i przykładów, zobacz Implementacja dostawców i rozszerzeń bazy danych .

Konstruktory

Nazwisko	Opis
RelationalOptionsExtension()	Tworzy nowy zestaw opcji z wszystkimi ustawionymi wartościami domyślnymi.
RelationalOptionsExtension(RelationalOptionsExtension)	Wywoływana przez konstruktor klasy pochodnej Clone() podczas implementowania metody.

Właściwości

Nazwisko	Opis
CommandTimeout	Limit czasu polecenia lub `null` jeśli żaden z nich nie został ustawiony.
Connection	Parametr DbConnectionlub `null` jeśli parametry połączenia został użyty zamiast pełnego obiektu połączenia.
ConnectionString	Connection string lub `null` jeśli DbConnection użyto elementu zamiast parametry połączenia.
ExecutionStrategyFactory	Fabryka do tworzenia domyślnego IExecutionStrategyobiektu lub `null` , jeśli żadna z nich nie została skonfigurowana.
Info	Informacje/metadane dotyczące rozszerzenia.
IsConnectionOwned	`true` Connection jeśli element jest własnością kontekstu i powinien zostać odpowiednio usunięty.
LogFragment	Tworzy fragment komunikatu na potrzeby rejestrowania, który zwykle zawiera informacje o wszelkich przydatnych opcjach innych niż domyślne, które zostały skonfigurowane.
MaxBatchSize	Maksymalna liczba instrukcji, które zostaną uwzględnione w poleceniach wysyłanych do bazy danych w czasie SaveChanges() lub `null` jeśli nie zostało ustawione żadne.
MigrationsAssembly	Nazwa zestawu zawierającego migracje lub `null` jeśli nie została ustawiona żadna.
MigrationsAssemblyObject	Zestaw zawierający migracje lub `null` jeśli nie został ustawiony.
MigrationsHistoryTableName	Nazwa tabeli do użycia dla tabeli historii migracji lub `null` jeśli nie została ustawiona żadna.
MigrationsHistoryTableSchema	Schemat używany dla tabeli historii migracji lub `null` jeśli nie został ustawiony.
MinBatchSize	Minimalna liczba instrukcji, które są wymagane dla polecenia z wieloma instrukcjami wysyłanymi do bazy danych w czasie SaveChanges() lub `null` jeśli nie zostało ustawione żadne.
ParameterizedCollectionMode	Skonfigurowany tryb tłumaczenia dla kolekcji sparametryzowanych.
ParameterizedCollectionTranslationMode	Skonfigurowany tryb tłumaczenia dla kolekcji sparametryzowanych.
QuerySplittingBehavior	Element QuerySplittingBehavior do użycia podczas ładowania powiązanych kolekcji w zapytaniu.
UseRelationalNulls	Wskazuje, czy należy używać semantyki relacyjnej bazy danych podczas porównywania wartości null. Domyślnie program Entity Framework będzie używać semantyki języka C# dla wartości null i generować język SQL, aby zrekompensować różnice w sposobie obsługi wartości null przez bazę danych.

Metody

Nazwisko	Opis
ApplyServices(IServiceCollection)	Dodaje usługi wymagane do wykonania wybranych opcji. Jest to używane, gdy nie ma zewnętrznego i IServiceProvider ef utrzymuje własnego dostawcę usług wewnętrznie. Dzięki temu dostawcy baz danych (i innych rozszerzeń) mogą rejestrować wymagane usługi podczas tworzenia dostawcy usług przez platformę EF.
Clone()	Zastąp tę metodę w klasie pochodnej, aby upewnić się, że wszystkie utworzone klony są również tej klasy.
Extract(IDbContextOptions)	Znajduje istniejącą RelationalOptionsExtension zarejestrowaną w podanych opcjach lub zgłasza, jeśli żadna z nich nie została zarejestrowana. Jest to zwykle używane do znajdowania konfiguracji relacyjnej, gdy wiadomo, że jest używany dostawca relacyjny.
GetServiceProviderHashCode()	Zwraca kod skrótu utworzony na podstawie wszystkich opcji, które mogłyby spowodować, że będzie potrzebny nowy IServiceProvider . Większość rozszerzeń nie ma takich opcji i powinna zwrócić zero.
Validate(IDbContextOptions)	Daje rozszerzenie szansę sprawdzenia, czy wszystkie opcje w rozszerzeniu są prawidłowe. Większość rozszerzeń nie ma nieprawidłowych kombinacji, więc będzie to no-op. Jeśli opcje są nieprawidłowe, należy zgłosić wyjątek.
WithCommandTimeout(Nullable<Int32>)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithConnection(DbConnection, Boolean)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithConnection(DbConnection)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithConnectionString(String)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithDefaultWarningConfiguration(CoreOptionsExtension)	Dodaje wartość domyślną WarningBehavior dla zdarzeń relacyjnych.
WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithMaxBatchSize(Nullable<Int32>)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithMigrationsAssembly(Assembly)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithMigrationsAssembly(String)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithMigrationsHistoryTableName(String)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithMigrationsHistoryTableSchema(String)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithMinBatchSize(Nullable<Int32>)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithParameterizedCollectionTranslationMode(ParameterizedCollectionTranslationMode)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithUseParameterizedCollectionMode(ParameterTranslationMode)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithUseQuerySplittingBehavior(QuerySplittingBehavior)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.
WithUseRelationalNulls(Boolean)	Tworzy nowe wystąpienie z wszystkimi opcjami takimi samymi jak w przypadku tego wystąpienia, ale z daną opcją została zmieniona. Nietypowe jest bezpośrednie wywołanie tej metody. Zamiast tego użyj polecenia DbContextOptionsBuilder.

Dotyczy

Opinia

Czy ta strona była pomocna?