RelationalOptionsExtension Classe

Définition

Espace de noms:

Microsoft.EntityFrameworkCore.Infrastructure

Assembly:

Microsoft.EntityFrameworkCore.Relational.dll

Paquet:

Microsoft.EntityFrameworkCore.Relational v8.0.0

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

Object

RelationalOptionsExtension

Implémente

IDbContextOptionsExtension

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.
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é.
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)	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.
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.