DocumentClient.CreateDatabaseIfNotExistsAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.Documents.Client

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 (falls nicht vorhanden) oder ruft (falls bereits vorhanden) eine Datenbankressource als asychronen 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 (201) oder die 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>>
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))

Parameter

database: Database

Die Spezifikation für das Database zu erstellende.

options: RequestOptions

(Optional) Der RequestOptions für die Anforderung.

Gibt zurück

Task<ResourceResponse<Database>>

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

Implementiert

CreateDatabaseIfNotExistsAsync(Database, RequestOptions)

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