CosmosClient.CreateAndInitializeAsync Methode
Definition
Wichtig
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.
Überlädt
| CreateAndInitializeAsync(String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken) |
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden. |
| CreateAndInitializeAsync(String, AzureKeyCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken) |
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und AzureKeyCredential. AzureKeyCredential ermöglicht das Ändern/Aktualisieren master-key/ResourceToken, während CosmosClient noch verwendet wird. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden. |
| CreateAndInitializeAsync(String, TokenCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken) |
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden. |
| CreateAndInitializeAsync(String, String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken) |
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden. |
CreateAndInitializeAsync(String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.
public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string connectionString, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);static member CreateAndInitializeAsync : string * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>Public Shared Function CreateAndInitializeAsync (connectionString As String, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)Parameter
- connectionString
- String
Die Verbindungszeichenfolge zum Cosmos-Konto. ex: AccountEndpoint=https://XXXXX.documents.azure.com:443/; AccountKey=SuperSecretKey;
- containers
- IReadOnlyList<ValueTuple<String,String>>
Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.
- cosmosClientOptions
- CosmosClientOptions
(Optional) Clientoptionen
- cancellationToken
- CancellationToken
(Optional) Abbruchtoken
Gibt zurück
Ein CosmosClient-Objekt.
Beispiele
Der CosmosClient wird mit dem ConnectionString erstellt, und 2 Container im Konto werden initialisiert.
using Microsoft.Azure.Cosmos;
List<(string, string)> containersToInitialize = new List<(string, string)>
{ ("DatabaseName1", "ContainerName1"), ("DatabaseName2", "ContainerName2") };
CosmosClient cosmosClient = await CosmosClient.CreateAndInitializeAsync("connection-string-from-portal",
containersToInitialize)
// Dispose cosmosClient at application exit
Gilt für:
CreateAndInitializeAsync(String, AzureKeyCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und AzureKeyCredential. AzureKeyCredential ermöglicht das Ändern/Aktualisieren master-key/ResourceToken, während CosmosClient noch verwendet wird.
Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.
public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string accountEndpoint, Azure.AzureKeyCredential authKeyOrResourceTokenCredential, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);static member CreateAndInitializeAsync : string * Azure.AzureKeyCredential * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>Public Shared Function CreateAndInitializeAsync (accountEndpoint As String, authKeyOrResourceTokenCredential As AzureKeyCredential, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)Parameter
- accountEndpoint
- String
Der zu verwendende Cosmos-Dienstendpunkt
- authKeyOrResourceTokenCredential
- AzureKeyCredential
AzureKeyCredential mit master-Schlüssel oder Ressourcentoken.
- containers
- IReadOnlyList<ValueTuple<String,String>>
Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.
- cosmosClientOptions
- CosmosClientOptions
(Optional) Clientoptionen
- cancellationToken
- CancellationToken
(Optional) Abbruchtoken
Gibt zurück
Ein CosmosClient-Objekt.
Beispiele
Der CosmosClient wird mit accountEndpoint, AccountKey oder ResourceToken erstellt, und 2 Container im Konto werden initialisiert.
using Microsoft.Azure.Cosmos;
List<(string, string)> containersToInitialize = new List<(string, string)>
{ ("DatabaseName1", "ContainerName1"), ("DatabaseName2", "ContainerName2") };
AzureKeyCredential keyCredential = new AzureKeyCredential("account-master-key/ResourceToken");
CosmosClient cosmosClient = await CosmosClient.CreateAndInitializeAsync("account-endpoint-from-portal",
keyCredential,
containersToInitialize)
....
// To udpate key/credentials
keyCredential.Update("updated master-key/ResourceToken");
// Dispose cosmosClient at application exit
Hinweise
AzureKeyCredential ermöglicht das Ändern/Aktualisieren master-key/ResourceToken, wenn CosmosClient weiterhin verwendet wird.
Gilt für:
CreateAndInitializeAsync(String, TokenCredential, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.
public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string accountEndpoint, Azure.Core.TokenCredential tokenCredential, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);static member CreateAndInitializeAsync : string * Azure.Core.TokenCredential * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>Public Shared Function CreateAndInitializeAsync (accountEndpoint As String, tokenCredential As TokenCredential, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)Parameter
- accountEndpoint
- String
Der zu verwendende Cosmos-Dienstendpunkt.
- tokenCredential
- TokenCredential
TokenCredentialDas Token, das AAD-Token für die Autorisierung bereitstellen soll.
- containers
- IReadOnlyList<ValueTuple<String,String>>
Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.
- cosmosClientOptions
- CosmosClientOptions
(Optional) Clientoptionen
- cancellationToken
- CancellationToken
(Optional) Abbruchtoken
Gibt zurück
Ein CosmosClient-Objekt.
Gilt für:
CreateAndInitializeAsync(String, String, IReadOnlyList<ValueTuple<String,String>>, CosmosClientOptions, CancellationToken)
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. Darüber hinaus initialisiert es den Client mit bereitgestellten Containern, d. h. das SDK erwärmt die Caches und Verbindungen, bevor der erste Aufruf des Diensts erfolgt. Verwenden Sie dies, um beim Starten Ihrer Anwendung eine geringere Latenz zu erzielen. CosmosClient ist threadsicher. Es wird empfohlen, eine einzelne instance von CosmosClient pro Lebensdauer der Anwendung beizubehalten, was eine effiziente Verbindungsverwaltung und -leistung ermöglicht. Weitere Informationen finden Sie im Leistungsleitfaden.
public static System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient> CreateAndInitializeAsync (string accountEndpoint, string authKeyOrResourceToken, System.Collections.Generic.IReadOnlyList<(string databaseId, string containerId)> containers, Microsoft.Azure.Cosmos.CosmosClientOptions cosmosClientOptions = default, System.Threading.CancellationToken cancellationToken = default);static member CreateAndInitializeAsync : string * string * System.Collections.Generic.IReadOnlyList<ValueTuple<string, string>> * Microsoft.Azure.Cosmos.CosmosClientOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.CosmosClient>Public Shared Function CreateAndInitializeAsync (accountEndpoint As String, authKeyOrResourceToken As String, containers As IReadOnlyList(Of ValueTuple(Of String, String)), Optional cosmosClientOptions As CosmosClientOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of CosmosClient)Parameter
- accountEndpoint
- String
Der zu verwendende Cosmos-Dienstendpunkt
- authKeyOrResourceToken
- String
Der Cosmos-Kontoschlüssel oder das Ressourcentoken, das zum Erstellen des Clients verwendet werden soll.
- containers
- IReadOnlyList<ValueTuple<String,String>>
Zu initialisierende Container, die durch den Datenbank- und Containernamen identifiziert werden.
- cosmosClientOptions
- CosmosClientOptions
(Optional) Clientoptionen
- cancellationToken
- CancellationToken
(Optional) Abbruchtoken
Gibt zurück
Ein CosmosClient-Objekt.
Beispiele
Der CosmosClient wird mit accountEndpoint, AccountKey oder ResourceToken erstellt, und 2 Container im Konto werden initialisiert.
using Microsoft.Azure.Cosmos;
List<(string, string)> containersToInitialize = new List<(string, string)>
{ ("DatabaseName1", "ContainerName1"), ("DatabaseName2", "ContainerName2") };
CosmosClient cosmosClient = await CosmosClient.CreateAndInitializeAsync("account-endpoint-from-portal",
"account-key-from-portal",
containersToInitialize)
// Dispose cosmosClient at application exit
Hinweise
Der zurückgegebene Verweis garantiert keine Anmeldeinformationen oder Konnektivitätsüberprüfungen, da die Initialisierung keine Netzwerkaufrufe durchführt.
Gilt für:
Azure SDK for .NET
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für