DocumentClient.CreateDatabaseIfNotExistsAsync Método

Referência

Definição

Namespace:: Microsoft.Azure.Documents.Client

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

Pacotes:: Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

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.

Cria(se não existir) ou obtém(se já existir) um recurso de banco de dados como uma operação assíncrona no serviço do Azure Cosmos DB. Você pode marcar o código status da resposta para determinar se o banco de dados foi criado recentemente(201) ou se o banco de dados existente foi retornado(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

A especificação para o Database a ser criado.

options: RequestOptions

(Opcional) O RequestOptions para a solicitação.

Retornos

Task<ResourceResponse<Database>>

O Database que foi criado em um objeto de tarefa que representa a resposta de serviço para a operação assíncrona.

Implementações

CreateDatabaseIfNotExistsAsync(Database, RequestOptions)

Exceções

ArgumentNullException

Se database não estiver definido.

AggregateException

Representa uma consolidação de falhas que ocorreram durante o processamento assíncrono. Procure em InnerExceptions para encontrar as exceções reais.

DocumentClientException

Essa exceção pode encapsular muitos tipos diferentes de erros. Para determinar o erro específico, sempre examine a propriedade StatusCode.

Exemplos

O exemplo a seguir cria um novo Database com uma propriedade ID de 'MyDatabase' Este snippet de código destina-se a ser usado de dentro de um método assíncrono, pois usa o await palavra-chave

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

Se você quiser construir um Database de dentro de um método síncrono, precisará usar o código a seguir

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

Aplica-se a