CosmosDbContextOptionsBuilder Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente l'esecuzione di una configurazione specifica di Cosmos su DbContextOptions.
[System.Runtime.CompilerServices.Nullable(0)]
public class CosmosDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.ICosmosDbContextOptionsBuilderInfrastructurepublic class CosmosDbContextOptionsBuilderpublic class CosmosDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.ICosmosDbContextOptionsBuilderInfrastructure[<System.Runtime.CompilerServices.Nullable(0)>]
type CosmosDbContextOptionsBuilder = class
interface ICosmosDbContextOptionsBuilderInfrastructuretype CosmosDbContextOptionsBuilder = classtype CosmosDbContextOptionsBuilder = class
interface ICosmosDbContextOptionsBuilderInfrastructurePublic Class CosmosDbContextOptionsBuilder
Implements ICosmosDbContextOptionsBuilderInfrastructurePublic Class CosmosDbContextOptionsBuilder- Ereditarietà
-
CosmosDbContextOptionsBuilder
- Attributi
- Implementazioni
Commenti
Le istanze di questa classe vengono restituite da una chiamata a CosmosDbContextOptionsExtensions.UseCosmos{TContext} e non sono progettate per essere costruite direttamente nel codice dell'applicazione.
Per altre informazioni ed esempi, vedere Uso di DbContextOptions e Accesso a Azure Cosmos DB con EF Core.
Costruttori
| Nome | Descrizione |
|---|---|
| CosmosDbContextOptionsBuilder(DbContextOptionsBuilder) |
Inizializza una nuova istanza della classe CosmosDbContextOptionsBuilder. |
Metodi
| Nome | Descrizione |
|---|---|
| BulkExecutionAllowed(Boolean) |
Imposta il valore booleano per abilitare la funzionalità di esecuzione in blocco di Cosmos DB SDK. L'abilitazione di questa funzionalità può migliorare la velocità effettiva per operazioni di scrittura di piccole dimensioni, ma può aumentare la latenza. È consigliabile solo per scenari con velocità effettiva elevata e senza latenza. Poiché i batch transazionali non possono essere eseguiti in modalità bulk, tutte le operazioni in batch da EF non useranno l'esecuzione bulk. Per assicurarsi che le operazioni vengano eseguite in blocco, è consigliabile disabilitare l'invio in batch impostando Never. Per altre informazioni, vedere Salvataggio dei dati - provider Azure Cosmos DB. |
| ConnectionMode(ConnectionMode) |
Configura il contesto per l'uso della modalità di connessione fornita. |
| ContentResponseOnWriteEnabled(Boolean) |
Obsoleti.
Imposta il valore booleano in modo che restituisca solo le intestazioni e il codice di stato nella risposta di Cosmos DB per l'operazione di scrittura dell'elemento, ad esempio Create, Upsert, Patch e Replace. Se si imposta l'opzione su false, la risposta avrà una risorsa Null. Ciò riduce il carico di rete e CPU non inviando la risorsa sulla rete e serializzandola nel client. |
| ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>) |
Configura il contesto per l'uso dell'oggetto fornito IExecutionStrategy. |
| GatewayModeMaxConnectionLimit(Int32) |
Configura il numero massimo di connessioni simultanee consentite per l'endpoint del servizio di destinazione nel servizio Azure Cosmos DB. |
| HttpClientFactory(Func<HttpClient>) |
Configura il contesto per l'uso di una factory specifica HttpClient . |
| IdleTcpConnectionTimeout(TimeSpan) |
Configura la quantità di tempo di inattività dopo la chiusura delle connessioni inutilizzate. |
| LimitToEndpoint(Boolean) |
Limita le operazioni all'endpoint fornito. |
| MaxRequestsPerTcpConnection(Int32) |
Configura il numero di richieste consentite contemporaneamente tramite una singola connessione TCP. Quando più richieste sono in esecuzione contemporaneamente, il client diretto/TCP aprirà connessioni aggiuntive. |
| MaxTcpConnectionsPerEndpoint(Int32) |
Configura il numero massimo di connessioni TCP che possono essere aperte a ogni back-end di Cosmos DB. Insieme a MaxRequestsPerTcpConnection, questa impostazione limita il numero di richieste inviate simultaneamente a un singolo back-end di Cosmos DB (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint). |
| OpenTcpConnectionTimeout(TimeSpan) |
Configura la quantità di tempo consentita per il tentativo di stabilire una connessione. |
| PreferredRegions(IReadOnlyList<String>) |
Configura il contesto per l'uso delle aree preferite fornite per gli account di database con replica geografica. |
| Region(String) |
Configura il contesto per l'uso dell'area con replica geografica specificata. |
| RequestTimeout(TimeSpan) |
Configura il timeout durante la connessione al servizio Azure Cosmos DB. Il numero specifica il tempo di attesa per il ritorno della risposta dal peer di rete. |
| SessionTokenManagementMode(SessionTokenManagementMode) |
Imposta l'oggetto SessionTokenManagementMode da utilizzare. Per impostazione predefinita, FullyAutomatic verrà usato . Qualsiasi altra modalità è rilevante solo quando l'applicazione deve gestire manualmente i token di sessione. Ad esempio: se si usa un servizio di bilanciamento del carico round robin che non mantiene l'affinità di sessione tra le richieste. La gestione manuale dei token di sessione può interrompere la coerenza della sessione quando non viene gestita correttamente. Fare riferimento a Usare i token di sessione per altri dettagli. |
| WebProxy(IWebProxy) |
Configura le informazioni sul proxy usate per le richieste Web. |
| WithOption(Func<CosmosOptionsExtension,CosmosOptionsExtension>) |
Imposta un'opzione clonando l'estensione usata per archiviare le impostazioni. In questo modo il generatore non modifica le opzioni già in uso altrove. |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ICosmosDbContextOptionsBuilderInfrastructure.OptionsBuilder |
Ottiene il generatore di opzioni di base. |
