DocumentClient.CreateDatabaseIfNotExistsAsync Método

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.Documents.Client

Ensamblados:: Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Paquetes:: Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.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í.

Crea (si no existe) u obtiene (si ya existe) un recurso de base de datos como una operación asincrónica en el servicio Azure Cosmos DB. Puede comprobar el código de estado de la respuesta para determinar si la base de datos se creó recientemente (201) o la base de datos existente se devolvió(200)

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Database>> CreateDatabaseIfNotExistsAsync (Microsoft.Azure.Documents.Database database, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateDatabaseIfNotExistsAsync : Microsoft.Azure.Documents.Database * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Database>>
override this.CreateDatabaseIfNotExistsAsync : Microsoft.Azure.Documents.Database * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Database>>

Public Function CreateDatabaseIfNotExistsAsync (database As Database, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Database))

Parámetros

database: Database

Especificación de que Database se va a crear.

options: RequestOptions

(Opcional) para RequestOptions la solicitud.

Devoluciones

Task<ResourceResponse<Database>>

Database que se creó dentro de un objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Implementaciones

CreateDatabaseIfNotExistsAsync(Database, RequestOptions)

Excepciones

ArgumentNullException

Si database no se establece.

AggregateException

Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.

DocumentClientException

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode.

Ejemplos

En el ejemplo siguiente se crea un nuevo Database con una propiedad Id de "MyDatabase". Este fragmento de código está pensado para usarse desde dentro de un método asincrónico, ya que usa la palabra clave await.

using (IDocumentClient client = new DocumentClient(new Uri("service endpoint"), "auth key"))
{
    Database db = await client.CreateDatabaseIfNotExistsAsync(new Database { Id = "MyDatabase" });
}

Si desea construir un Database desde dentro de un método sincrónico, debe usar el código siguiente.

using (IDocumentClient client = new DocumentClient(new Uri("service endpoint"), "auth key"))
{
    Database db = client.CreateDatabaseIfNotExistsAsync(new Database { Id = "MyDatabase" }).Result;
}

Se aplica a