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 DbContextOptionsBuilderde .
public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
[System.Runtime.CompilerServices.Nullable(0)]
public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
type RelationalOptionsExtension = class
interface IDbContextOptionsExtension
[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalOptionsExtension = class
interface IDbContextOptionsExtension
Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension
- Héritage
-
RelationalOptionsExtension
- Attributs
- 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
| Nom | Description |
|---|---|
| RelationalOptionsExtension() |
Crée un ensemble d’options avec tout ce qui est 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
| Nom | Description |
|---|---|
| CommandTimeout |
Délai d’expiration de la commande ou |
| Connection |
|
| ConnectionString |
La chaîne de connexion, ou |
| ExecutionStrategyFactory |
Fabrique pour la création de la valeur par défaut IExecutionStrategyou |
| 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 non par défaut utiles 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 des migrations ou |
| MigrationsAssemblyObject |
Assembly qui contient des 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-instruction envoyée à la base de données pendant SaveChanges() ou |
| ParameterizedCollectionMode |
Mode de traduction configuré pour les collections paramétrables. |
| ParameterizedCollectionTranslationMode |
Mode de traduction configuré pour les collections paramétrables. |
| QuerySplittingBehavior |
À QuerySplittingBehavior utiliser lors du chargement de collections associées dans une requête. |
| UseRelationalNulls |
Indique si la sémantique de base de données relationnelle doit être utilisée ou non lors de la comparaison des valeurs Null. Par défaut, Entity Framework utilise la sémantique C# pour les valeurs Null et génère SQL pour compenser les différences dans la façon dont la base de données gère les valeurs Null. |
Méthodes
| Nom | Description |
|---|---|
| ApplyServices(IServiceCollection) |
Ajoute les services requis pour que les options sélectionnées fonctionnent. Cela est utilisé lorsqu’il n’existe aucun fournisseur de services externe IServiceProvider et EF maintient 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 lors de la création d’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 enregistrement existant RelationalOptionsExtension sur les options données ou lève si aucun n’a été inscrit. Il est généralement utilisé pour trouver 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 un nouveau IServiceProvider besoin. La plupart des extensions n’ont pas de telles options et doivent retourner zéro. |
| Validate(IDbContextOptions) |
Donne à l’extension la possibilité de valider 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 no-op. 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 à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithConnection(DbConnection, Boolean) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithConnection(DbConnection) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithConnectionString(String) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel 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 à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithMaxBatchSize(Nullable<Int32>) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithMigrationsAssembly(Assembly) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithMigrationsAssembly(String) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithMigrationsHistoryTableName(String) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithMigrationsHistoryTableSchema(String) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithMinBatchSize(Nullable<Int32>) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithParameterizedCollectionTranslationMode(ParameterizedCollectionTranslationMode) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithUseParameterizedCollectionMode(ParameterTranslationMode) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithUseQuerySplittingBehavior(QuerySplittingBehavior) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |
| WithUseRelationalNulls(Boolean) |
Crée une instance avec toutes les options identiques à cette instance, mais avec l’option donnée modifiée. Il est inhabituel d’appeler cette méthode directement. Utilisez DbContextOptionsBuilder à la place. |