CosmosDbContextOptionsBuilder 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 à Cosmos d’effectuer une configuration spécifique sur DbContextOptions.
[System.Runtime.CompilerServices.Nullable(0)]
public class CosmosDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.ICosmosDbContextOptionsBuilderInfrastructure
public class CosmosDbContextOptionsBuilder
public class CosmosDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.ICosmosDbContextOptionsBuilderInfrastructure
[<System.Runtime.CompilerServices.Nullable(0)>]
type CosmosDbContextOptionsBuilder = class
interface ICosmosDbContextOptionsBuilderInfrastructure
type CosmosDbContextOptionsBuilder = class
type CosmosDbContextOptionsBuilder = class
interface ICosmosDbContextOptionsBuilderInfrastructure
Public Class CosmosDbContextOptionsBuilder
Implements ICosmosDbContextOptionsBuilderInfrastructure
Public Class CosmosDbContextOptionsBuilder
- Héritage
-
CosmosDbContextOptionsBuilder
- Attributs
- Implémente
Remarques
Les instances de cette classe sont retournées à partir d’un appel vers CosmosDbContextOptionsExtensions.UseCosmos{TContext} lequel elle n’est pas conçue pour être construite directement dans votre code d’application.
Pour plus d’informations et d’exemples, consultez Utilisation de DbContextOptions et accès à Azure Cosmos DB avec EF Core.
Constructeurs
| Nom | Description |
|---|---|
| CosmosDbContextOptionsBuilder(DbContextOptionsBuilder) |
Initialise une nouvelle instance de la classe CosmosDbContextOptionsBuilder. |
Méthodes
| Nom | Description |
|---|---|
| BulkExecutionAllowed(Boolean) |
Définit la valeur booléenne pour activer la fonctionnalité d’exécution en bloc du Kit de développement logiciel (SDK) Cosmos DB. L’activation de cette fonctionnalité peut améliorer le débit pour les opérations d’écriture de petite taille, mais peut augmenter la latence. Il est recommandé uniquement pour les scénarios à débit élevé et non sensibles à la latence. Étant donné que les lots transactionnels ne peuvent pas être exécutés en mode en bloc, toutes les opérations traitées par EF n’utilisent pas l’exécution en bloc. Pour vous assurer que les opérations sont exécutées en bloc, envisagez de désactiver le traitement par lots en définissant Never. Pour plus d’informations, consultez Enregistrement de données - Azure Cosmos DB Fournisseur. |
| ConnectionMode(ConnectionMode) |
Configure le contexte pour utiliser le mode de connexion fourni. |
| ContentResponseOnWriteEnabled(Boolean) |
Obsolète.
Définit la valeur booléenne pour renvoyer uniquement les en-têtes et le code d’état dans la réponse Cosmos DB pour l’opération d’écriture d’élément comme Create, Upsert, Patch et Replace. Si vous définissez l’option sur false, la réponse aura une ressource Null. Cela réduit la charge réseau et processeur en n’envoyant pas la ressource sur le réseau et en sérialisant celle-ci sur le client. |
| ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>) |
Configure le contexte pour utiliser le fichier fourni IExecutionStrategy. |
| GatewayModeMaxConnectionLimit(Int32) |
Configure le nombre maximal de connexions simultanées autorisées pour le point de terminaison de service cible dans le service Azure Cosmos DB. |
| HttpClientFactory(Func<HttpClient>) |
Configure le contexte pour utiliser une fabrique spécifique HttpClient . |
| IdleTcpConnectionTimeout(TimeSpan) |
Configure la durée d’inactivité après laquelle les connexions inutilisées sont fermées. |
| LimitToEndpoint(Boolean) |
Limite les opérations au point de terminaison fourni. |
| MaxRequestsPerTcpConnection(Int32) |
Configure le nombre de requêtes autorisées simultanément sur une seule connexion TCP. Lorsque d’autres requêtes sont en cours simultanément, le client direct/TCP ouvre des connexions supplémentaires. |
| MaxTcpConnectionsPerEndpoint(Int32) |
Configure le nombre maximal de connexions TCP qui peuvent être ouvertes à chaque back-end Cosmos DB. Avec MaxRequestsPerTcpConnection, ce paramètre limite le nombre de requêtes qui sont envoyées simultanément à un seul back-end Cosmos DB (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint). |
| OpenTcpConnectionTimeout(TimeSpan) |
Configure la durée autorisée pour essayer d’établir une connexion. |
| PreferredRegions(IReadOnlyList<String>) |
Configure le contexte pour utiliser les régions préférées fournies pour les comptes de base de données géorépliqués. |
| Region(String) |
Configure le contexte pour utiliser la région géorépliquée fournie. |
| RequestTimeout(TimeSpan) |
Configure le délai d’expiration lors de la connexion au service Azure Cosmos DB. Le nombre spécifie le temps d’attente de la réponse à revenir de l’homologue réseau. |
| SessionTokenManagementMode(SessionTokenManagementMode) |
Définit la SessionTokenManagementMode valeur à utiliser. Par défaut, FullyAutomatic sera utilisé. Tout autre mode n’est pertinent que lorsque votre application doit gérer manuellement les jetons de session. Par exemple : si vous utilisez un équilibreur de charge tourniquet qui ne conserve pas l’affinité de session entre les requêtes. La gestion manuelle des jetons de session peut interrompre la cohérence de session lorsqu’elle n’est pas gérée correctement. Voir Utiliser des jetons de session pour plus d’informations. |
| WebProxy(IWebProxy) |
Configure les informations de proxy utilisées pour les requêtes web. |
| WithOption(Func<CosmosOptionsExtension,CosmosOptionsExtension>) |
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. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| ICosmosDbContextOptionsBuilderInfrastructure.OptionsBuilder |
Obtient le générateur d’options principales. |