CosmosClient Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| CosmosClient() |
Créer un cosmosClient utilisé pour les tests fictifs |
| CosmosClient(String, CosmosClientOptions) |
Crée un cosmosClient avec le chaîne de connexion. CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances. |
| CosmosClient(String, AzureKeyCredential, CosmosClientOptions) |
Crée un cosmosClient avec la chaîne URI du point de terminaison de compte et AzureKeyCredential. AzureKeyCredential permet de modifier/mettre à jour master-key/ResourceToken pendant que CosmosClient est toujours en cours d’utilisation. CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances. |
| CosmosClient(String, TokenCredential, CosmosClientOptions) |
Crée un CosmosClient avec la chaîne d’URI du point de terminaison de compte et TokenCredential. CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances. |
| CosmosClient(String, String, CosmosClientOptions) |
Crée un cosmosClient avec la chaîne d’URI du point de terminaison de compte et la clé de compte. CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances. |
CosmosClient()
Créer un cosmosClient utilisé pour les tests fictifs
protected CosmosClient ();Protected Sub New ()S’applique à
CosmosClient(String, CosmosClientOptions)
Crée un cosmosClient avec le chaîne de connexion.
CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances.
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)Paramètres
- connectionString
- String
Le chaîne de connexion au compte cosmos. ex : AccountEndpoint=https://XXXXX.documents.azure.com:443/ ; AccountKey=SuperSecretKey ;
- clientOptions
- CosmosClientOptions
Options clientes (facultatives)
Exemples
CosmosClient est créé avec le chaîne de connexion et configuré pour utiliser la région « USA Est 2 ».
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
Remarques
La référence retournée ne garantit pas les informations d’identification ou les validations de connectivité, car la création n’effectue aucun appel réseau.
Voir aussi
S’applique à
CosmosClient(String, AzureKeyCredential, CosmosClientOptions)
Crée un cosmosClient avec la chaîne URI du point de terminaison de compte et AzureKeyCredential. AzureKeyCredential permet de modifier/mettre à jour master-key/ResourceToken pendant que CosmosClient est toujours en cours d’utilisation.
CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances.
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)Paramètres
- accountEndpoint
- String
Point de terminaison de service cosmos à utiliser
- authKeyOrResourceTokenCredential
- AzureKeyCredential
AzureKeyCredential avec master clé ou jeton de ressource.
- clientOptions
- CosmosClientOptions
Options clientes (facultatives)
Exemples
CosmosClient est créé avec la région AccountEndpoint, AccountKey ou ResourceToken et configuré pour utiliser la région « USA Est 2 ».
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
Remarques
AzureKeyCredential permet de modifier/mettre à jour master-key/ResourceToken whle CosmosClient est toujours en cours d’utilisation. La référence retournée ne garantit pas les informations d’identification ou les validations de connectivité, car la création n’effectue aucun appel réseau.
Voir aussi
S’applique à
CosmosClient(String, TokenCredential, CosmosClientOptions)
Crée un CosmosClient avec la chaîne d’URI du point de terminaison de compte et TokenCredential.
CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances.
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)Paramètres
- accountEndpoint
- String
Point de terminaison de service cosmos à utiliser.
- tokenCredential
- TokenCredential
TokenCredentialJeton permettant de fournir un jeton AAD pour l’autorisation.
- clientOptions
- CosmosClientOptions
Options clientes (facultatives)
Remarques
La référence retournée ne garantit pas les informations d’identification ou les validations de connectivité, car la création n’effectue aucun appel réseau.
S’applique à
CosmosClient(String, String, CosmosClientOptions)
Crée un cosmosClient avec la chaîne d’URI du point de terminaison de compte et la clé de compte.
CosmosClient est thread-safe. Il est recommandé de conserver une seule instance de CosmosClient par durée de vie de l’application, ce qui permet une gestion et des performances efficaces des connexions. Reportez-vous au guide de performances.
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)Paramètres
- accountEndpoint
- String
Point de terminaison de service cosmos à utiliser
- authKeyOrResourceToken
- String
Clé de compte cosmos ou jeton de ressource à utiliser pour créer le client.
- clientOptions
- CosmosClientOptions
Options clientes (facultatives)
Exemples
CosmosClient est créé avec la région AccountEndpoint, AccountKey ou ResourceToken et configuré pour utiliser la région « USA Est 2 ».
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
Remarques
La référence retournée ne garantit pas les informations d’identification ou les validations de connectivité, car la création n’effectue aucun appel réseau.
Voir aussi
S’applique à
Azure SDK for .NET
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour