CosmosDbContextOptionsBuilder Klasse

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht die Ausführung von Cosmos spezifische Konfiguration.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

Vererbung: Object
CosmosDbContextOptionsBuilder

Attribute: NullableAttribute

Implementiert: ICosmosDbContextOptionsBuilderInfrastructure

Hinweise

Instanzen dieser Klasse werden von einem Aufruf CosmosDbContextOptionsExtensions.UseCosmos{TContext} an die Klasse zurückgegeben und sind nicht für die direkte Konstruktion in Ihrem Anwendungscode konzipiert.

Weitere Informationen und Beispiele finden Sie unter Verwenden von DbContextOptions und zugreifen auf Azure Cosmos DB mit EF Core.

Konstruktoren

Name	Beschreibung
CosmosDbContextOptionsBuilder(DbContextOptionsBuilder)	Initialisiert eine neue Instanz der CosmosDbContextOptionsBuilder-Klasse.

Methoden

Name	Beschreibung
BulkExecutionAllowed(Boolean)	Legt den booleschen Wert fest, um das Cosmos DB SDK-Massenausführungsfeature zu aktivieren. Durch aktivieren dieses Feature kann der Durchsatz für kleine Schreibvorgänge verbessert werden, die Latenz kann jedoch erhöht werden. Es wird nur für Szenarien mit hohem Durchsatz empfohlen, die nicht latenzempfindlich sind. Da Transaktionsbatches nicht im Massenmodus ausgeführt werden können, werden von EF verarbeitete Vorgänge nicht zur Massenausführung verwendet. Um sicherzustellen, dass Vorgänge in Massen ausgeführt werden, sollten Sie die Batchverarbeitung durch Festlegen Neverdeaktivieren. Weitere Informationen finden Sie unter Speichern von Daten – Azure Cosmos DB Provider.
ConnectionMode(ConnectionMode)	Konfiguriert den Kontext für die Verwendung des bereitgestellten Verbindungsmodus.
ContentResponseOnWriteEnabled(Boolean)	Veraltet. Legt den booleschen Wert fest, um nur die Header und den Statuscode in der Cosmos DB-Antwort zum Schreiben von Elementvorgängen wie Create, Upsert, Patch und Replace zurückzugeben. Wenn Sie die Option auf "false" festlegen, hat die Antwort eine NULL-Ressource. Dadurch wird die Netzwerk- und CPU-Auslastung reduziert, indem die Ressource nicht über das Netzwerk zurückgesendet und auf dem Client serialisiert wird.
ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>)	Konfiguriert den Kontext für die Verwendung der bereitgestellten IExecutionStrategy.
GatewayModeMaxConnectionLimit(Int32)	Konfiguriert die maximale Anzahl gleichzeitiger Verbindungen, die für den Zieldienstendpunkt im Azure Cosmos DB-Dienst zulässig sind.
HttpClientFactory(Func<HttpClient>)	Konfiguriert den Kontext für die Verwendung einer bestimmten HttpClient Factory.
IdleTcpConnectionTimeout(TimeSpan)	Konfiguriert die Leerlaufzeit, nach der nicht verwendete Verbindungen geschlossen werden.
LimitToEndpoint(Boolean)	Beschränkt die Vorgänge auf den bereitgestellten Endpunkt.
MaxRequestsPerTcpConnection(Int32)	Konfiguriert die Anzahl der Anforderungen, die gleichzeitig über eine einzelne TCP-Verbindung zulässig sind. Wenn sich mehr Anforderungen gleichzeitig in Flight befinden, öffnet der Direkte/TCP-Client zusätzliche Verbindungen.
MaxTcpConnectionsPerEndpoint(Int32)	Konfiguriert die maximale Anzahl von TCP-Verbindungen, die für jedes Cosmos DB-Back-End geöffnet werden können. Zusammen mit MaxRequestsPerTcpConnection beschränkt diese Einstellung die Anzahl der Anforderungen, die gleichzeitig an ein einzelnes Cosmos DB-Back-End gesendet werden (MaxRequestsPerTcpConnection x MaxTcpConnectionPerEndpoint).
OpenTcpConnectionTimeout(TimeSpan)	Konfiguriert den Zeitraum, der für den Versuch, eine Verbindung herzustellen, zulässig ist.
PreferredRegions(IReadOnlyList<String>)	Konfiguriert den Kontext für die Verwendung der bereitgestellten bevorzugten Regionen für georeplizierte Datenbankkonten.
Region(String)	Konfiguriert den Kontext für die Verwendung der bereitgestellten geo-replizierten Region.
RequestTimeout(TimeSpan)	Konfiguriert das Timeout beim Herstellen einer Verbindung mit dem Azure Cosmos DB-Dienst. Die Zahl gibt die Zeit an, bis die Antwort vom Netzwerkspeer zurückgegeben wird.
SessionTokenManagementMode(SessionTokenManagementMode)	Legt die zu verwendende Fest SessionTokenManagementMode . FullyAutomatic Standardmäßig wird verwendet. Jeder andere Modus ist nur relevant, wenn Ihre Anwendung Sitzungstoken manuell verwalten muss. Beispiel: Wenn Sie einen Roundrobin-Lastenausgleich verwenden, der die Sitzungsaffinität zwischen Anforderungen nicht aufrechterhält. Die manuelle Verwaltung von Sitzungstoken kann die Sitzungskonsistenz unterbrechen, wenn sie nicht ordnungsgemäß behandelt wird. Siehe Verwenden von Sitzungstoken finden Sie weitere Details.
WebProxy(IWebProxy)	Konfiguriert die Proxyinformationen, die für Webanforderungen verwendet werden.
WithOption(Func<CosmosOptionsExtension,CosmosOptionsExtension>)	Legt eine Option fest, indem die Erweiterung, die zum Speichern der Einstellungen verwendet wird, klonen. Dadurch wird sichergestellt, dass der Generator keine Optionen ändert, die bereits an anderer Stelle verwendet werden.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
ICosmosDbContextOptionsBuilderInfrastructure.OptionsBuilder	Ruft den Hauptoptionen-Generator ab.

Gilt für:

Feedback

War diese Seite hilfreich?