CosmosDbContextOptionsBuilder Klasa

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Umożliwia wykonywanie określonej konfiguracji usługi Cosmos na platformie 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

Dziedziczenie: Object
CosmosDbContextOptionsBuilder

Atrybuty: NullableAttribute

Implementuje: ICosmosDbContextOptionsBuilderInfrastructure

Uwagi

Wystąpienia tej klasy są zwracane z wywołania metody i CosmosDbContextOptionsExtensions.UseCosmos{TContext} nie są przeznaczone do bezpośredniego konstruowania w kodzie aplikacji.

Aby uzyskać więcej informacji i przykładów, zobacz Using DbContextOptions (Używanie obiektów DbContextOptions) i Accessing Azure Cosmos DB with EF Core (Uzyskiwanie dostępu do Azure Cosmos DB za pomocą programu EF Core).

Konstruktory

Nazwisko	Opis
CosmosDbContextOptionsBuilder(DbContextOptionsBuilder)	Inicjuje nowe wystąpienie klasy CosmosDbContextOptionsBuilder.

Metody

Nazwisko	Opis
BulkExecutionAllowed(Boolean)	Ustawia wartość logiczną, aby włączyć funkcję wykonywania zbiorczego zestawu SDK usługi Cosmos DB. Włączenie tej funkcji może zwiększyć przepływność małych operacji zapisu, ale może zwiększyć opóźnienie. Zalecane jest tylko w przypadku scenariuszy z dużą przepływnością i niezwiązanymi z opóźnieniami. Ponieważ transakcyjne partie nie mogą być wykonywane w trybie zbiorczym, żadne operacje podzielone na partie przez program EF nie będą używać wykonywania zbiorczego. Aby upewnić się, że operacje są wykonywane zbiorczo, rozważ wyłączenie przetwarzania wsadowego przez ustawienie .Never Aby uzyskać więcej informacji, zobacz Zapisywanie danych — dostawca Azure Cosmos DB.
ConnectionMode(ConnectionMode)	Konfiguruje kontekst tak, aby używał podanego trybu połączenia.
ContentResponseOnWriteEnabled(Boolean)	Przestarzałe. Ustawia wartość logiczną tak, aby zwracała tylko nagłówki i kod stanu w odpowiedzi usługi Cosmos DB na potrzeby operacji zapisu elementu, takiej jak Create, Upsert, Patch i Replace. Ustawienie opcji false spowoduje, że odpowiedź będzie mieć zasób o wartości null. Zmniejsza to obciążenie sieci i procesora CPU, nie wysyłając zasobu z powrotem przez sieć i serializując je na kliencie.
ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>)	Konfiguruje kontekst tak, aby używał podanego IExecutionStrategyelementu .
GatewayModeMaxConnectionLimit(Int32)	Konfiguruje maksymalną liczbę współbieżnych połączeń dozwolonych dla docelowego punktu końcowego usługi w usłudze Azure Cosmos DB.
HttpClientFactory(Func<HttpClient>)	Konfiguruje kontekst do używania określonej HttpClient fabryki.
IdleTcpConnectionTimeout(TimeSpan)	Konfiguruje czas bezczynności, po którym nieużywane połączenia są zamykane.
LimitToEndpoint(Boolean)	Ogranicza operacje do podanego punktu końcowego.
MaxRequestsPerTcpConnection(Int32)	Konfiguruje liczbę żądań dozwolonych jednocześnie za pośrednictwem pojedynczego połączenia TCP. Gdy więcej żądań jest w locie jednocześnie, klient direct/TCP otworzy dodatkowe połączenia.
MaxTcpConnectionsPerEndpoint(Int32)	Konfiguruje maksymalną liczbę połączeń TCP, które mogą być otwarte dla każdego zaplecza usługi Cosmos DB. Razem z maxRequestsPerTcpConnection to ustawienie ogranicza liczbę żądań wysyłanych jednocześnie do pojedynczego zaplecza usługi Cosmos DB (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint).
OpenTcpConnectionTimeout(TimeSpan)	Konfiguruje czas dozwolony na próbę nawiązania połączenia.
PreferredRegions(IReadOnlyList<String>)	Konfiguruje kontekst tak, aby używał podanych preferowanych regionów dla kont baz danych replikowanych geograficznie.
Region(String)	Konfiguruje kontekst tak, aby używał podanego regionu replikowanego geograficznie.
RequestTimeout(TimeSpan)	Konfiguruje limit czasu podczas nawiązywania połączenia z usługą Azure Cosmos DB. Liczba określa czas oczekiwania na powrót odpowiedzi z elementu równorzędnego sieci.
SessionTokenManagementMode(SessionTokenManagementMode)	Ustawia wartość SessionTokenManagementMode , która ma być używana. Domyślnie FullyAutomatic będzie używany. Każdy inny tryb jest istotny tylko wtedy, gdy aplikacja musi ręcznie zarządzać tokenami sesji. Na przykład: jeśli używasz modułu równoważenia obciążenia z działaniem okrężnym, który nie utrzymuje koligacji sesji między żądaniami. Ręczne zarządzanie tokenami sesyjnymi może przerwać spójność sesji, gdy nie jest prawidłowo obsługiwane. Zobacz Korzystanie z tokenów sesji aby uzyskać więcej informacji.
WebProxy(IWebProxy)	Konfiguruje informacje o serwerze proxy używane dla żądań internetowych.
WithOption(Func<CosmosOptionsExtension,CosmosOptionsExtension>)	Ustawia opcję przez sklonowanie rozszerzenia używanego do przechowywania ustawień. Dzięki temu konstruktor nie modyfikuje opcji, które są już używane w innym miejscu.

Jawne implementacje interfejsu

Nazwisko	Opis
ICosmosDbContextOptionsBuilderInfrastructure.OptionsBuilder	Pobiera podstawowe opcje konstruktora.

Dotyczy

Opinia

Czy ta strona była pomocna?