DocumentClient.CreateDatabaseIfNotExistsAsync Méthode

Référence

Définition

Espace de noms:: Microsoft.Azure.Documents.Client

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

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée(si n’existe pas) ou obtient (si existe déjà) une ressource de base de données en tant qu’opération asychrone dans le service Azure Cosmos DB. Vous pouvez case activée le code status de la réponse pour déterminer si la base de données a été nouvellement créée(201) ou si la base de données existante a été retournée(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))

Paramètres

database: Database

Spécification du Database à créer.

options: RequestOptions

(Facultatif) RequestOptions pour la demande.

Retours

Task<ResourceResponse<Database>>

Database qui a été créé dans un objet de tâche représentant la réponse du service pour l’opération asynchrone.

Implémente

CreateDatabaseIfNotExistsAsync(Database, RequestOptions)

Exceptions

ArgumentNullException

Si database n’est pas défini.

AggregateException

Représente une consolidation des échecs qui se sont produits pendant le traitement asynchrone. Recherchez la ou les exceptions réelles dans InnerExceptions.

DocumentClientException

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode.

Exemples

L’exemple ci-dessous crée un avec Database la propriété Id « MyDatabase » Cet extrait de code est destiné à être utilisé à partir d’une méthode asynchrone, car il utilise le mot clé

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

Si vous souhaitez construire un Database à partir d’une méthode synchrone, vous devez utiliser le code suivant

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

S’applique à

Partager via