IDocumentClient.CreateDatabaseAsync(Database, RequestOptions) Méthode

Référence

Définition

Espace de noms:: Microsoft.Azure.Documents

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 une ressource de base de données en tant qu’opération asychronous dans le service 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))

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.

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. Voici quelques codes courants que vous pouvez obtenir lors de la création d’une base de données :

StatusCode	Raison de l’exception
400	BadRequest : cela signifie qu’un problème s’est produit avec l’objet de base de données fourni. Il est probable qu’aucun ID n’a été fourni pour la nouvelle base de données.
409	Conflit : cela signifie qu’un Database avec un ID correspondant au champ id de `database` déjà existant.

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.CreateDatabaseAsync(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.CreateDatabaseAsync(new Database { Id = "MyDatabase" }).Result;
}

S’applique à

Partager via