Partager via


RelationalOptionsExtension Classe

Définition

Représente les options gérées par les fournisseurs de base de données relationnelle. Ces options sont définies à l’aide de DbContextOptionsBuilder.

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension
Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension
Héritage
RelationalOptionsExtension
Implémente

Remarques

Les instances de cette classe sont conçues pour être immuables. Pour modifier une option, appelez l’une des options « With... » méthodes permettant d’obtenir une nouvelle instance avec l’option modifiée.

Pour plus d’informations et d’exemples, consultez Implémentation des fournisseurs et extensions de base de données .

Constructeurs

RelationalOptionsExtension()

Crée un nouvel ensemble d’options avec tout défini sur les valeurs par défaut.

RelationalOptionsExtension(RelationalOptionsExtension)

Appelé par un constructeur de classe dérivée lors de l’implémentation de la Clone() méthode .

Propriétés

CommandTimeout

Délai d’expiration de la commande ou null si aucune n’a été définie.

Connection

DbConnectionou null si un chaîne de connexion a été utilisé à la place de l’objet de connexion complet.

ConnectionString

Le chaîne de connexion, ou null si un DbConnection a été utilisé au lieu d’un chaîne de connexion.

ExecutionStrategyFactory

Fabrique pour la création de la valeur par défaut IExecutionStrategy, ou null si aucune n’a été configurée.

Info

Informations/métadonnées sur l’extension.

IsConnectionOwned

true si appartient Connection au contexte et doit être supprimé de manière appropriée.

LogFragment

Crée un fragment de message pour la journalisation contenant généralement des informations sur toutes les options utiles autres que les options par défaut qui ont été configurées.

MaxBatchSize

Nombre maximal d’instructions qui seront incluses dans les commandes envoyées à la base de données pendant SaveChanges() ou null si aucune n’a été définie.

MigrationsAssembly

Nom de l’assembly qui contient les migrations, ou null si aucune n’a été définie.

MigrationsHistoryTableName

Nom de la table à utiliser pour la table d’historique des migrations, ou null si aucune n’a été définie.

MigrationsHistoryTableSchema

Schéma à utiliser pour la table d’historique des migrations, ou null si aucune n’a été définie.

MinBatchSize

Nombre minimal d’instructions nécessaires pour une commande multi-instructions envoyée à la base de données pendant SaveChanges() ou null si aucune instruction n’a été définie.

QuerySplittingBehavior

à utiliser lors du QuerySplittingBehavior chargement de collections associées dans une requête.

UseRelationalNulls

Indique s’il faut ou non utiliser la sémantique de base de données relationnelle lors de la comparaison de valeurs Null. Par défaut, Entity Framework utilise la sémantique C# pour les valeurs Null et génère du CODE SQL pour compenser les différences dans la façon dont la base de données gère les valeurs Null.

Méthodes

ApplyServices(IServiceCollection)

Ajoute les services requis pour que les options sélectionnées fonctionnent. Cela est utilisé lorsqu’il n’y a pas d’externe IServiceProvider et qu’EF gère son propre fournisseur de services en interne. Cela permet aux fournisseurs de base de données (et à d’autres extensions) d’inscrire leurs services requis quand EF crée un fournisseur de services.

Clone()

Remplacez cette méthode dans une classe dérivée pour vous assurer que tout clone créé est également de cette classe.

Extract(IDbContextOptions)

Recherche un inscrit existant RelationalOptionsExtension sur les options données ou lève si aucun n’a été inscrit. Cela est généralement utilisé pour rechercher une configuration relationnelle lorsqu’il est connu qu’un fournisseur relationnel est utilisé.

GetServiceProviderHashCode()

Retourne un code de hachage créé à partir de toutes les options qui entraîneraient la nécessité d’en avoir un nouveau IServiceProvider . La plupart des extensions n’ont pas de telles options et doivent retourner zéro.

Validate(IDbContextOptions)

Donne à l’extension la possibilité de vérifier que toutes les options de l’extension sont valides. La plupart des extensions n’ont pas de combinaisons non valides. Il s’agit donc d’une opération sans opération. Si les options ne sont pas valides, une exception doit être levée.

WithCommandTimeout(Nullable<Int32>)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithConnection(DbConnection, Boolean)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithConnection(DbConnection)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithConnectionString(String)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithDefaultWarningConfiguration(CoreOptionsExtension)

Ajoute la valeur par défaut WarningBehavior pour les événements relationnels.

WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithMaxBatchSize(Nullable<Int32>)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithMigrationsAssembly(String)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithMigrationsHistoryTableName(String)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithMigrationsHistoryTableSchema(String)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithMinBatchSize(Nullable<Int32>)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithUseQuerySplittingBehavior(QuerySplittingBehavior)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

WithUseRelationalNulls(Boolean)

Crée une instance avec toutes les options identiques à celles de cette instance, mais avec l’option donnée modifiée. Il est rare d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place.

S’applique à