IDocumentClient.CreateDatabaseIfNotExistsAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Documents

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

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt (wenn nicht vorhanden) oder ruft (falls bereits vorhanden) eine Datenbankressource als aychronen Vorgang im Azure Cosmos DB-Dienst ab. Sie können den status Code aus der Antwort überprüfen, um festzustellen, ob die Datenbank neu erstellt wurde(201) oder ob eine vorhandene Datenbank zurückgegeben wurde(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))

Parameter

database: Database

Die Spezifikation für die Database zu erstellende.

options: RequestOptions

(Optional) Die RequestOptions für die Anforderung.

Gibt zurück

Task<ResourceResponse<Database>>

Die Database , die in einem Aufgabenobjekt erstellt wurde, das die Dienstantwort für den asynchronen Vorgang darstellt.

Ausnahmen

ArgumentNullException

Wenn database nicht festgelegt ist.

AggregateException

Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.

DocumentClientException

Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an.

Beispiele

Im folgenden Beispiel wird eine neue Database mit der Id-Eigenschaft "MyDatabase" erstellt. Dieser Codeausschnitt ist für die Verwendung innerhalb einer asynchronen Methode vorgesehen, da die await-Schlüsselwort (keyword)

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

Wenn Sie eine aus einer Database synchronen Methode erstellen möchten, müssen Sie den folgenden Code verwenden.

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

Gilt für:

Freigeben über