CosmosClient Constructores

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.Cosmos

Ensamblado:: Microsoft.Azure.Cosmos.Client.dll

Paquete:: Microsoft.Azure.Cosmos v3.36.0

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.CosmosClient

Public 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.

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.CosmosClient

Public 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.

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.CosmosClient

Public 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.

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.CosmosClient

Public 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

Compartir a través de

CosmosClient Constructores

Definición

Sobrecargas

CosmosClient()

Se aplica a

CosmosClient(String, CosmosClientOptions)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

CosmosClient(String, AzureKeyCredential, CosmosClientOptions)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

CosmosClient(String, TokenCredential, CosmosClientOptions)

Parámetros

Comentarios

Se aplica a

CosmosClient(String, String, CosmosClientOptions)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales