Partager via


IDocumentClient.CreateDatabaseIfNotExistsAsync Méthode

Définition

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

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

Exceptions

Si database n’est pas défini.

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

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 à

Voir aussi