CosmosClient Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| CosmosClient() |
Creación de una instancia de CosmosClient que se usa para pruebas ficticias |
| CosmosClient(String, CosmosClientOptions) |
Crea un objeto CosmosClient con el cadena de conexión. CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento. |
| CosmosClient(String, AzureKeyCredential, CosmosClientOptions) |
Crea un nuevo CosmosClient con la cadena de URI del punto de conexión de la cuenta y AzureKeyCredential. AzureKeyCredential permite cambiar o actualizar master-key/ResourceToken mientras CosmosClient todavía está en uso. CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento. |
| CosmosClient(String, TokenCredential, CosmosClientOptions) |
Crea un nuevo CosmosClient con la cadena de URI del punto de conexión de la cuenta y TokenCredential. CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento. |
| CosmosClient(String, String, CosmosClientOptions) |
Crea un nuevo CosmosClient con la cadena de URI del punto de conexión de cuenta y la clave de cuenta. CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento. |
CosmosClient()
Creación de una instancia de CosmosClient que se usa para pruebas ficticias
protected CosmosClient ();Protected Sub New ()Se aplica a
CosmosClient(String, CosmosClientOptions)
Crea un objeto CosmosClient con el cadena de conexión.
CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento.
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
La cadena de conexión a la cuenta de Cosmos. por ejemplo: AccountEndpoint=https://XXXXX.documents.azure.com:443/; AccountKey=SuperSecretKey;
- clientOptions
- CosmosClientOptions
(Opcional) opciones de cliente
Ejemplos
CosmosClient se crea con el cadena de conexión y se configura para usar la región "Este de EE. UU. 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
Comentarios
La referencia devuelta no garantiza credenciales ni validaciones de conectividad porque la creación no realiza ninguna llamada de red.
Consulte también
Se aplica a
CosmosClient(String, AzureKeyCredential, CosmosClientOptions)
Crea un nuevo CosmosClient con la cadena de URI del punto de conexión de la cuenta y AzureKeyCredential. AzureKeyCredential permite cambiar o actualizar master-key/ResourceToken mientras CosmosClient todavía está en uso.
CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento.
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
Punto de conexión de servicio de Cosmos que se va a usar
- authKeyOrResourceTokenCredential
- AzureKeyCredential
AzureKeyCredential con clave maestra o token de recurso.
- clientOptions
- CosmosClientOptions
(Opcional) opciones de cliente
Ejemplos
CosmosClient se crea con accountEndpoint, AccountKey o ResourceToken y se configura para usar la región "Este de EE. UU. 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
Comentarios
AzureKeyCredential permite cambiar o actualizar master-key/ResourceToken whle CosmosClient todavía está en uso. La referencia devuelta no garantiza credenciales ni validaciones de conectividad porque la creación no realiza ninguna llamada de red.
Consulte también
Se aplica a
CosmosClient(String, TokenCredential, CosmosClientOptions)
Crea un nuevo CosmosClient con la cadena de URI del punto de conexión de la cuenta y TokenCredential.
CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento.
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
Punto de conexión de servicio de Cosmos que se va a usar.
- tokenCredential
- TokenCredential
TokenCredentialToken para proporcionar el token de AAD para la autorización.
- clientOptions
- CosmosClientOptions
(Opcional) opciones de cliente
Comentarios
La referencia devuelta no garantiza credenciales ni validaciones de conectividad porque la creación no realiza ninguna llamada de red.
Se aplica a
CosmosClient(String, String, CosmosClientOptions)
Crea un nuevo CosmosClient con la cadena de URI del punto de conexión de cuenta y la clave de cuenta.
CosmosClient es seguro para subprocesos. Se recomienda mantener una única instancia de CosmosClient por duración de la aplicación, lo que permite una administración y un rendimiento de conexiones eficaces. Consulte la guía de rendimiento.
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
Punto de conexión de servicio de Cosmos que se va a usar
- authKeyOrResourceToken
- String
Clave de cuenta de Cosmos o token de recurso que se va a usar para crear el cliente.
- clientOptions
- CosmosClientOptions
(Opcional) opciones de cliente
Ejemplos
CosmosClient se crea con accountEndpoint, AccountKey o ResourceToken y se configura para usar la región "Este de EE. UU. 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
Comentarios
La referencia devuelta no garantiza credenciales ni validaciones de conectividad porque la creación no realiza ninguna llamada de red.
Consulte también
Se aplica a
Azure SDK for .NET
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de