RelationalOptionsExtension Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 |
Connection |
DbConnectionou |
ConnectionString |
Le chaîne de connexion, ou |
ExecutionStrategyFactory |
Fabrique pour la création de la valeur par défaut IExecutionStrategy, ou |
Info |
Informations/métadonnées sur l’extension. |
IsConnectionOwned |
|
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 |
MigrationsAssembly |
Nom de l’assembly qui contient les migrations, ou |
MigrationsHistoryTableName |
Nom de la table à utiliser pour la table d’historique des migrations, ou |
MigrationsHistoryTableSchema |
Schéma à utiliser pour la table d’historique des migrations, ou |
MinBatchSize |
Nombre minimal d’instructions nécessaires pour une commande multi-instructions envoyée à la base de données pendant SaveChanges() ou |
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. |