DocumentClient.CreateDatabaseAsync(Database, RequestOptions) 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 eine Datenbankressource als asychronen Vorgang im Azure Cosmos DB-Dienst.

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>>
override this.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))

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

CreateDatabaseAsync(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. Einige häufige Codes, die Sie beim Erstellen einer Datenbank erhalten können, sind:

StatusCode	Ausnahmegrund
400	BadRequest: Dies bedeutet, dass mit dem bereitgestellten Datenbankobjekt ein Fehler aufgetreten ist. Es ist wahrscheinlich, dass für die neue Datenbank keine ID angegeben wurde.
409	Konflikt: Dies bedeutet, dass eine Database mit einer ID übereinstimmt, die dem ID-Feld von `database` bereits vorhanden entspricht.

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

Gilt für:

Freigeben über