CosmosClient Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| CosmosClient() |
Criar um novo CosmosClient usado para testes fictícios |
| CosmosClient(String, CosmosClientOptions) |
Cria um novo CosmosClient com o cadeia de conexão. O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho. |
| CosmosClient(String, AzureKeyCredential, CosmosClientOptions) |
Cria um novo CosmosClient com a cadeia de caracteres de URI do ponto de extremidade da conta e AzureKeyCredential. O AzureKeyCredential permite alterar/atualizar master-key/ResourceToken enquanto o CosmosClient ainda está em uso. O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho. |
| CosmosClient(String, TokenCredential, CosmosClientOptions) |
Cria um novo CosmosClient com a cadeia de caracteres de URI do ponto de extremidade da conta e TokenCredential. O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho. |
| CosmosClient(String, String, CosmosClientOptions) |
Cria um novo CosmosClient com a cadeia de caracteres de URI do ponto de extremidade da conta e a chave da conta. O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho. |
CosmosClient()
Criar um novo CosmosClient usado para testes fictícios
protected CosmosClient ();Protected Sub New ()Aplica-se a
CosmosClient(String, CosmosClientOptions)
Cria um novo CosmosClient com o cadeia de conexão.
O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho.
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)Parâmetros
- connectionString
- String
O cadeia de conexão para a conta do Cosmos. ex: AccountEndpoint=https://XXXXX.documents.azure.com:443/; AccountKey=SuperSecretKey;
- clientOptions
- CosmosClientOptions
Opções de cliente (opcional)
Exemplos
O CosmosClient é criado com o cadeia de conexão e configurado para usar a região "Leste dos EUA 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
Comentários
A referência retornada não garante credenciais ou validações de conectividade porque a criação não faz chamadas de rede.
Confira também
Aplica-se a
CosmosClient(String, AzureKeyCredential, CosmosClientOptions)
Cria um novo CosmosClient com a cadeia de caracteres de URI do ponto de extremidade da conta e AzureKeyCredential. O AzureKeyCredential permite alterar/atualizar master-key/ResourceToken enquanto o CosmosClient ainda está em uso.
O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho.
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)Parâmetros
- accountEndpoint
- String
O ponto de extremidade de serviço do Cosmos a ser usado
- authKeyOrResourceTokenCredential
- AzureKeyCredential
AzureKeyCredential com master chave ou token de recurso..
- clientOptions
- CosmosClientOptions
Opções de cliente (opcional)
Exemplos
O CosmosClient é criado com AccountEndpoint, AccountKey ou ResourceToken e configurado para usar a região "Leste dos EUA 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
Comentários
O AzureKeyCredential permite alterar/atualizar master-key/ResourceToken whle CosmosClient ainda está em uso. A referência retornada não garante credenciais ou validações de conectividade porque a criação não faz chamadas de rede.
Confira também
Aplica-se a
CosmosClient(String, TokenCredential, CosmosClientOptions)
Cria um novo CosmosClient com a cadeia de caracteres de URI do ponto de extremidade da conta e TokenCredential.
O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho.
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)Parâmetros
- accountEndpoint
- String
O ponto de extremidade de serviço cosmos a ser usado.
- tokenCredential
- TokenCredential
TokenCredentialO token para fornecer o token do AAD para autorização.
- clientOptions
- CosmosClientOptions
Opções de cliente (opcional)
Comentários
A referência retornada não garante credenciais ou validações de conectividade porque a criação não faz chamadas de rede.
Aplica-se a
CosmosClient(String, String, CosmosClientOptions)
Cria um novo CosmosClient com a cadeia de caracteres de URI do ponto de extremidade da conta e a chave da conta.
O CosmosClient é thread-safe. É recomendável manter uma única instância do CosmosClient por tempo de vida do aplicativo que permite o gerenciamento e o desempenho de conexões eficientes. Consulte o guia de desempenho.
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)Parâmetros
- accountEndpoint
- String
O ponto de extremidade de serviço do Cosmos a ser usado
- authKeyOrResourceToken
- String
A chave da conta cosmos ou o token de recurso a ser usado para criar o cliente.
- clientOptions
- CosmosClientOptions
Opções de cliente (opcional)
Exemplos
O CosmosClient é criado com AccountEndpoint, AccountKey ou ResourceToken e configurado para usar a região "Leste dos EUA 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
Comentários
A referência retornada não garante credenciais ou validações de conectividade porque a criação não faz chamadas de rede.
Confira também
Aplica-se a
Azure SDK for .NET
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários