CosmosClient Konstruktoren
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
| CosmosClient() |
Erstellen eines neuen CosmosClients, der für Pseudotests verwendet wird |
| CosmosClient(String, CosmosClientOptions) |
Erstellt einen neuen CosmosClient mit dem Verbindungszeichenfolge. 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. |
| CosmosClient(String, AzureKeyCredential, CosmosClientOptions) |
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. 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. |
| CosmosClient(String, TokenCredential, CosmosClientOptions) |
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential. 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. |
| CosmosClient(String, String, CosmosClientOptions) |
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und dem Kontoschlüssel. 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. |
CosmosClient()
Erstellen eines neuen CosmosClients, der für Pseudotests verwendet wird
protected CosmosClient ();Protected Sub New ()Gilt für:
CosmosClient(String, CosmosClientOptions)
Erstellt einen neuen CosmosClient mit dem Verbindungszeichenfolge.
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 CosmosClient (string connectionString, Microsoft.Azure.Cosmos.CosmosClientOptions clientOptions = default);new Microsoft.Azure.Cosmos.CosmosClient : string * Microsoft.Azure.Cosmos.CosmosClientOptions -> Microsoft.Azure.Cosmos.CosmosClientPublic Sub New (connectionString As String, Optional clientOptions As CosmosClientOptions = Nothing)Parameter
- connectionString
- String
Die Verbindungszeichenfolge zum cosmos-Konto. beispiel: AccountEndpoint=https://XXXXX.documents.azure.com:443/; AccountKey=SuperSecretKey;
- clientOptions
- CosmosClientOptions
Clientoptionen (optional)
Beispiele
Der CosmosClient wird mit der Verbindungszeichenfolge erstellt und für die Verwendung der Region "USA, Osten 2" konfiguriert.
using Microsoft.Azure.Cosmos;
CosmosClient cosmosClient = new CosmosClient(
"account-endpoint-from-portal",
"account-key-from-portal",
new CosmosClientOptions()
{
ApplicationRegion = Regions.EastUS2,
});
// Dispose cosmosClient at application exit
Hinweise
Der zurückgegebene Verweis garantiert keine Anmeldeinformationen oder Konnektivitätsüberprüfungen, da bei der Erstellung keine Netzwerkaufrufe durchgeführt werden.
Weitere Informationen
Gilt für:
CosmosClient(String, AzureKeyCredential, CosmosClientOptions)
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.
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 CosmosClient (string accountEndpoint, Azure.AzureKeyCredential authKeyOrResourceTokenCredential, Microsoft.Azure.Cosmos.CosmosClientOptions clientOptions = default);new Microsoft.Azure.Cosmos.CosmosClient : string * Azure.AzureKeyCredential * Microsoft.Azure.Cosmos.CosmosClientOptions -> Microsoft.Azure.Cosmos.CosmosClientPublic Sub New (accountEndpoint As String, authKeyOrResourceTokenCredential As AzureKeyCredential, Optional clientOptions As CosmosClientOptions = Nothing)Parameter
- accountEndpoint
- String
Der zu verwendende Cosmos-Dienstendpunkt
- authKeyOrResourceTokenCredential
- AzureKeyCredential
AzureKeyCredential mit master-Schlüssel- oder Ressourcentoken.
- clientOptions
- CosmosClientOptions
Clientoptionen (optional)
Beispiele
Der CosmosClient wird mit der Region "AccountEndpoint", "AccountKey" oder "ResourceToken" erstellt und für die Verwendung der Region "USA, Osten 2" konfiguriert.
using Microsoft.Azure.Cosmos;
AzureKeyCredential keyCredential = new AzureKeyCredential("account-master-key/ResourceToken");
CosmosClient cosmosClient = new CosmosClient(
"account-endpoint-from-portal",
keyCredential,
new CosmosClientOptions()
{
ApplicationRegion = Regions.EastUS2,
});
....
// 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 noch verwendet wird. Der zurückgegebene Verweis garantiert keine Anmeldeinformationen oder Konnektivitätsüberprüfungen, da bei der Erstellung keine Netzwerkaufrufe durchgeführt werden.
Weitere Informationen
Gilt für:
CosmosClient(String, TokenCredential, CosmosClientOptions)
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und TokenCredential.
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 CosmosClient (string accountEndpoint, Azure.Core.TokenCredential tokenCredential, Microsoft.Azure.Cosmos.CosmosClientOptions clientOptions = default);new Microsoft.Azure.Cosmos.CosmosClient : string * Azure.Core.TokenCredential * Microsoft.Azure.Cosmos.CosmosClientOptions -> Microsoft.Azure.Cosmos.CosmosClientPublic Sub New (accountEndpoint As String, tokenCredential As TokenCredential, Optional clientOptions As CosmosClientOptions = Nothing)Parameter
- accountEndpoint
- String
Der zu verwendende Cosmos-Dienstendpunkt.
- tokenCredential
- TokenCredential
TokenCredentialDas Token, das AAD-Token für die Autorisierung bereitstellt.
- clientOptions
- CosmosClientOptions
Clientoptionen (optional)
Hinweise
Der zurückgegebene Verweis garantiert keine Anmeldeinformationen oder Konnektivitätsüberprüfungen, da bei der Erstellung keine Netzwerkaufrufe durchgeführt werden.
Gilt für:
CosmosClient(String, String, CosmosClientOptions)
Erstellt einen neuen CosmosClient mit der URI-Zeichenfolge des Kontoendpunkts und dem Kontoschlüssel.
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 CosmosClient (string accountEndpoint, string authKeyOrResourceToken, Microsoft.Azure.Cosmos.CosmosClientOptions clientOptions = default);new Microsoft.Azure.Cosmos.CosmosClient : string * string * Microsoft.Azure.Cosmos.CosmosClientOptions -> Microsoft.Azure.Cosmos.CosmosClientPublic Sub New (accountEndpoint As String, authKeyOrResourceToken As String, Optional clientOptions As CosmosClientOptions = Nothing)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.
- clientOptions
- CosmosClientOptions
Clientoptionen (optional)
Beispiele
Der CosmosClient wird mit der Region "AccountEndpoint", "AccountKey" oder "ResourceToken" erstellt und für die Verwendung der Region "USA, Osten 2" konfiguriert.
using Microsoft.Azure.Cosmos;
CosmosClient cosmosClient = new CosmosClient(
"account-endpoint-from-portal",
"account-key-from-portal",
new CosmosClientOptions()
{
ApplicationRegion = Regions.EastUS2,
});
// Dispose cosmosClient at application exit
Hinweise
Der zurückgegebene Verweis garantiert keine Anmeldeinformationen oder Konnektivitätsüberprüfungen, da bei der Erstellung keine Netzwerkaufrufe durchgeführt werden.
Weitere Informationen
Gilt für:
Azure SDK for .NET