Поделиться через


RelationalOptionsExtension Класс

Определение

Представляет параметры, управляемые поставщиками реляционных баз данных. Эти параметры задаются с помощью DbContextOptionsBuilder.

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension
Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension
Наследование
RelationalOptionsExtension
Реализации

Комментарии

Экземпляры этого класса предназначены для того, чтобы быть неизменяемыми. Чтобы изменить параметр, вызовите один из операторов With.... методы для получения нового экземпляра с измененным параметром .

Дополнительные сведения и примеры см. в разделе Реализация поставщиков и расширений баз данных .

Конструкторы

RelationalOptionsExtension()

Создает новый набор параметров со всеми значениями по умолчанию.

RelationalOptionsExtension(RelationalOptionsExtension)

Вызывается конструктором производного класса при реализации Clone() метода .

Свойства

CommandTimeout

Время ожидания команды или null значение , если оно не задано.

Connection

Значение DbConnectionили null , если вместо полного объекта соединения использовался строка подключения.

ConnectionString

Строка подключения или null значение , если DbConnection вместо строка подключения использовался .

ExecutionStrategyFactory

Фабрика для создания по умолчанию IExecutionStrategyили null , если ни одна из них не была настроена.

Info

Сведения или метаданные о расширении.

IsConnectionOwned

true Значение , Connection если объект принадлежит контексту и должен быть удален соответствующим образом.

LogFragment

Создает фрагмент сообщения для ведения журнала, который обычно содержит сведения о любых полезных параметрах, отличных от настроенных по умолчанию.

MaxBatchSize

Максимальное количество инструкций, которые будут включены в команды, отправляемые в базу данных во время SaveChanges() или null если они не были заданы.

MigrationsAssembly

Имя сборки, содержащей миграции, или null значение , если значение не задано.

MigrationsHistoryTableName

Имя таблицы, используемой для таблицы журнала миграций, или null значение , если оно не задано.

MigrationsHistoryTableSchema

Схема, используемая для таблицы журнала миграций, или null значение , если ни один из них не задан.

MinBatchSize

Минимальное количество инструкций, необходимых для выполнения команды с несколькими инструкциями, отправляемых в базу данных во время SaveChanges() или null если ни один из них не был задан.

QuerySplittingBehavior

Объект , используемый QuerySplittingBehavior при загрузке связанных коллекций в запросе.

UseRelationalNulls

Указывает, следует ли использовать семантику реляционной базы данных при сравнении значений NULL. По умолчанию Entity Framework использует семантику C# для значений NULL и создает SQL для компенсации различий в обработке значений NULL в базе данных.

Методы

ApplyServices(IServiceCollection)

Добавляет службы, необходимые для обеспечения работы выбранных параметров. Используется, когда внешний сервер отсутствует IServiceProvider , и EF обслуживает собственный поставщик услуг внутри системы. Это позволяет поставщикам баз данных (и другим расширениям) регистрировать необходимые службы, когда EF создает поставщика услуг.

Clone()

Переопределите этот метод в производном классе, чтобы гарантировать, что любой созданный клон также относится к этому классу.

Extract(IDbContextOptions)

Находит существующий RelationalOptionsExtension объект , зарегистрированный в заданных параметрах, или создает исключение, если ни один из них не был зарегистрирован. Обычно используется для поиска некоторой реляционной конфигурации, если известно, что используется реляционный поставщик.

GetServiceProviderHashCode()

Возвращает хэш-код, созданный из любых параметров, которые могут вызвать необходимость в новом IServiceProvider коде. Большинство расширений не имеют таких параметров и должны возвращать ноль.

Validate(IDbContextOptions)

Позволяет расширению проверить допустимость всех параметров в расширении. Большинство расширений не имеют недопустимых сочетаний, поэтому это не будет операций. Если параметры недопустимы, должно быть вызвано исключение.

WithCommandTimeout(Nullable<Int32>)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithConnection(DbConnection)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithConnection(DbConnection, Boolean)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithConnectionString(String)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithDefaultWarningConfiguration(CoreOptionsExtension)

Добавляет значение по умолчанию WarningBehavior для реляционных событий.

WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithMaxBatchSize(Nullable<Int32>)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithMigrationsAssembly(String)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithMigrationsHistoryTableName(String)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithMigrationsHistoryTableSchema(String)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithMinBatchSize(Nullable<Int32>)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithUseQuerySplittingBehavior(QuerySplittingBehavior)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

WithUseRelationalNulls(Boolean)

Создает новый экземпляр со всеми параметрами, теми же, что и для этого экземпляра, но с измененным параметром. Этот метод обычно вызывается напрямую. Вместо него используйте DbContextOptionsBuilder.

Применяется к