SqlServerDbContextOptionsBuilder 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.
Permet SQL Server configuration spécifique à effectuer sur DbContextOptions.
public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.Infrastructure.Internal.SqlServerOptionsExtension>[System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1 })]
public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.SqlEngineDbContextOptionsBuilderBase<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.SqlServer.Infrastructure.Internal.SqlServerOptionsExtension>[System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1, 1 })]
public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.SqlServer.Infrastructure.Internal.SqlServerOptionsExtension>type SqlServerDbContextOptionsBuilder = class
inherit RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder, SqlServerOptionsExtension>[<System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1 })>]
type SqlServerDbContextOptionsBuilder = class
inherit SqlEngineDbContextOptionsBuilderBase<SqlServerDbContextOptionsBuilder>[<System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1, 1 })>]
type SqlServerDbContextOptionsBuilder = class
inherit RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder, SqlServerOptionsExtension>Public Class SqlServerDbContextOptionsBuilder
Inherits RelationalDbContextOptionsBuilder(Of SqlServerDbContextOptionsBuilder, SqlServerOptionsExtension)Public Class SqlServerDbContextOptionsBuilder
Inherits SqlEngineDbContextOptionsBuilderBase(Of SqlServerDbContextOptionsBuilder)- Héritage
-
RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.Infrastructure.Internal.SqlServerOptionsExtension>SqlServerDbContextOptionsBuilder
- Héritage
-
SqlServerDbContextOptionsBuilder
- Héritage
-
RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.SqlServer.Infrastructure.Internal.SqlServerOptionsExtension>SqlServerDbContextOptionsBuilder
- Attributs
Remarques
Les instances de cette classe sont retournées à partir d’un appel vers SqlServerDbContextOptionsExtensions.UseSqlServer lequel elle n’est pas conçue pour être construite directement dans votre code d’application.
Constructeurs
| Nom | Description |
|---|---|
| SqlServerDbContextOptionsBuilder(DbContextOptionsBuilder) |
Initialise une nouvelle instance de la classe SqlServerDbContextOptionsBuilder. |
Propriétés
| Nom | Description |
|---|---|
| OptionsBuilder |
Obtient le générateur d’options principales. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
Méthodes
| Nom | Description |
|---|---|
| CloneExtension() |
Clone la configuration dans ce générateur. |
| CommandTimeout(Nullable<Int32>) |
Configure le temps d’attente (en secondes) avant de terminer la tentative d’exécution d’une commande et de générer une erreur. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| EnableRetryOnFailure() |
Configure le contexte pour utiliser la nouvelle tentative IExecutionStrategypar défaut. |
| EnableRetryOnFailure(ICollection<Int32>) |
Configure le contexte pour utiliser la nouvelle tentative IExecutionStrategypar défaut. |
| EnableRetryOnFailure(Int32, TimeSpan, ICollection<Int32>) |
Configure le contexte pour utiliser la nouvelle tentative IExecutionStrategypar défaut. Cette stratégie est spécifiquement adaptée aux SQL Server (y compris SQL Azure). Il est préconfiguré avec des numéros d’erreur pour les erreurs temporaires qui peuvent être retentées, mais des numéros d’erreur supplémentaires peuvent également être fournis. |
| EnableRetryOnFailure(Int32, TimeSpan, IEnumerable<Int32>) |
Configure le contexte pour utiliser la nouvelle tentative IExecutionStrategypar défaut. |
| EnableRetryOnFailure(Int32) |
Configure le contexte pour utiliser la nouvelle tentative IExecutionStrategypar défaut. |
| ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>) |
Configure le contexte pour utiliser le fichier fourni IExecutionStrategy. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| MaxBatchSize(Int32) |
Configure le nombre maximal d’instructions qui seront incluses dans les commandes envoyées à la base de données pendant SaveChanges(). (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| MigrationsAssembly(Assembly) |
Configure l’assembly dans lequel les migrations sont conservées pour ce contexte. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| MigrationsAssembly(String) |
Configure l’assembly dans lequel les migrations sont conservées pour ce contexte. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| MigrationsHistoryTable(String, String) |
Configure le nom de la table utilisée pour enregistrer les migrations qui ont été appliquées à la base de données. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| MinBatchSize(Int32) |
Configure le nombre minimal d’instructions nécessaires pour une commande multi-instruction envoyée à la base de données pendant SaveChanges(). (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| TranslateParameterizedCollectionsToConstants() |
Obsolète.
Configure le contexte pour traduire des collections paramétrables en constantes inline. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| TranslateParameterizedCollectionsToParameters() |
Obsolète.
Configure le contexte pour traduire des collections paramétrables en un seul paramètre de type tableau. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| UseAzureSqlDefaults(Boolean) |
Obsolète.
Configure le contexte pour utiliser les valeurs par défaut optimisées pour Azure SQL, y compris les nouvelles tentatives sur les erreurs. |
| UseCompatibilityLevel(Int32) |
Définit le niveau de compatibilité SQL Server utilisé par EF Core lors de l’interaction avec la base de données. Cela permet de configurer EF Core pour qu’il fonctionne avec des versions antérieures (ou ultérieures) de SQL Server.
|
| UseQuerySplittingBehavior(QuerySplittingBehavior) |
Configure l’utilisation lors du QuerySplittingBehavior chargement de collections associées dans une requête. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| UseRelationalNulls(Boolean) |
Configure le contexte pour utiliser la sémantique de base de données relationnelle 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. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
| UseRowNumberForPaging() |
Utilisez un ROW_NUMBER() dans les requêtes au lieu de OFFSET/FETCH. Cette méthode est rétrocompatible pour SQL Server 2005. |
| UseRowNumberForPaging(Boolean) |
Obsolète.
Utilisez un ROW_NUMBER() dans les requêtes au lieu de OFFSET/FETCH. Cette méthode est rétrocompatible pour SQL Server 2005. |
| WithOption(Func<TExtension,TExtension>) |
Définit une option en clonant l’extension utilisée pour stocker les paramètres. Cela garantit que le générateur ne modifie pas les options déjà utilisées ailleurs. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IRelationalDbContextOptionsBuilderInfrastructure.OptionsBuilder |
Obtient le générateur d’options principales. (Hérité de RelationalDbContextOptionsBuilder<TBuilder,TExtension>) |
Méthodes d’extension
| Nom | Description |
|---|---|
| UseNetTopologySuite(SqlServerDbContextOptionsBuilder) |
Utilisez NetTopologySuite pour accéder aux données spatiales SQL Server. |
