IDocumentClient.CreateDatabaseAsync(Database, RequestOptions) Método

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.Documents

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 un recurso de base de datos como una operación asincrónica en el servicio Azure Cosmos DB.

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

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

Public Function CreateDatabaseAsync (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.

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. Algunos códigos comunes que puede obtener al crear una base de datos son:

StatusCode	Motivo de la excepción
400	BadRequest: esto significa que algo estaba mal con el objeto de base de datos proporcionado. Es probable que no se haya proporcionado un identificador para la nueva base de datos.
409	Conflicto: significa que ya existía un Database con un identificador que coincide con el campo id de `database` .

Ejemplos

En el ejemplo siguiente se crea un nuevo Database con una propiedad Id de "MyDatabase" Este fragmento de código está diseñado 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.CreateDatabaseAsync(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.CreateDatabaseAsync(new Database { Id = "MyDatabase" }).Result;
}

Se aplica a