Partilhar via


RelationalOptionsExtension Classe

Definição

Representa as opções gerenciadas pelos provedores de banco de dados relacionais. Essas opções são definidas usando DbContextOptionsBuilder.

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension
Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension
Herança
RelationalOptionsExtension
Implementações

Comentários

As instâncias dessa classe foram projetadas para serem imutáveis. Para alterar uma opção, chame um dos 'Com...' métodos para obter uma nova instância com a opção alterada.

Consulte Implementação de provedores de banco de dados e extensões para obter mais informações e exemplos.

Construtores

RelationalOptionsExtension()

Cria um novo conjunto de opções com tudo definido como valores padrão.

RelationalOptionsExtension(RelationalOptionsExtension)

Chamado por um construtor de classe derivada ao implementar o Clone() método .

Propriedades

CommandTimeout

O tempo limite do comando ou null se nenhum tiver sido definido.

Connection

O DbConnectionou null se um cadeia de conexão foi usado em vez do objeto de conexão completo.

ConnectionString

O cadeia de conexão ou null se um DbConnection foi usado em vez de um cadeia de conexão.

ExecutionStrategyFactory

Uma fábrica para criar o padrão IExecutionStrategyou null se nenhuma tiver sido configurada.

Info

Informações/metadados sobre a extensão.

IsConnectionOwned

true se o Connection pertencer ao contexto e deve ser descartado adequadamente.

LogFragment

Cria um fragmento de mensagem para registro em log normalmente contendo informações sobre as opções úteis não padrão que foram configuradas.

MaxBatchSize

O número máximo de instruções que serão incluídas em comandos enviados ao banco de dados durante SaveChanges() ou null se nenhuma tiver sido definida.

MigrationsAssembly

O nome do assembly que contém migrações ou null se nenhum tiver sido definido.

MigrationsHistoryTableName

O nome da tabela a ser usada para a tabela de histórico de migrações ou null se nenhuma tiver sido definida.

MigrationsHistoryTableSchema

O esquema a ser usado para a tabela de histórico de migrações ou null se nenhum tiver sido definido.

MinBatchSize

O número mínimo de instruções necessárias para um comando de várias instruções enviado ao banco de dados durante SaveChanges() ou null se nenhuma tiver sido definida.

QuerySplittingBehavior

O QuerySplittingBehavior a ser usado ao carregar coleções relacionadas em uma consulta.

UseRelationalNulls

Indica se a semântica de banco de dados relacional deve ou não ser usada ao comparar valores nulos. Por padrão, o Entity Framework usará a semântica C# para valores nulos e gerará SQL para compensar as diferenças na forma como o banco de dados lida com nulos.

Métodos

ApplyServices(IServiceCollection)

Adiciona os serviços necessários para fazer as opções selecionadas funcionarem. Isso é usado quando não há nenhum externo IServiceProvider e o EF está mantendo seu próprio provedor de serviços internamente. Isso permite que os provedores de banco de dados (e outras extensões) registrem seus serviços necessários quando o EF estiver criando um provedor de serviços.

Clone()

Substitua esse método em uma classe derivada para garantir que qualquer clone criado também seja dessa classe.

Extract(IDbContextOptions)

Localiza um registrado existente RelationalOptionsExtension nas opções fornecidas ou lança se nenhum foi registrado. Normalmente, isso é usado para localizar alguma configuração relacional quando se sabe que um provedor relacional está sendo usado.

GetServiceProviderHashCode()

Retorna um código hash criado com base em qualquer opção que faria com que um novo IServiceProvider fosse necessário. A maioria das extensões não tem essas opções e deve retornar zero.

Validate(IDbContextOptions)

Dá à extensão a chance de validar se todas as opções na extensão são válidas. A maioria das extensões não tem combinações inválidas e, portanto, isso será uma operação não operacional. Se as opções forem inválidas, uma exceção deverá ser gerada.

WithCommandTimeout(Nullable<Int32>)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithConnection(DbConnection, Boolean)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithConnection(DbConnection)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithConnectionString(String)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithDefaultWarningConfiguration(CoreOptionsExtension)

Adiciona o padrão WarningBehavior para eventos relacionais.

WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithMaxBatchSize(Nullable<Int32>)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithMigrationsAssembly(String)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithMigrationsHistoryTableName(String)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithMigrationsHistoryTableSchema(String)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithMinBatchSize(Nullable<Int32>)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithUseQuerySplittingBehavior(QuerySplittingBehavior)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

WithUseRelationalNulls(Boolean)

Cria uma nova instância com todas as opções iguais às desta instância, mas com a opção fornecida alterada. É incomum chamar esse método diretamente. Use DbContextOptionsBuilder.

Aplica-se a