IDocumentClient.CreateUserAsync Methode
Definition
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.
Überlädt
| CreateUserAsync(String, User, RequestOptions) |
Erstellt ein Benutzerobjekt als asychronen Vorgang im Azure Cosmos DB-Dienst. |
| CreateUserAsync(Uri, User, RequestOptions) |
Erstellt einen Benutzer als asychronen Vorgang im Azure Cosmos DB-Dienst. |
CreateUserAsync(String, User, RequestOptions)
Erstellt ein Benutzerobjekt als asychronen Vorgang im Azure Cosmos DB-Dienst.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> CreateUserAsync (string databaseLink, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);abstract member CreateUserAsync : string * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>Public Function CreateUserAsync (databaseLink As String, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))Parameter
- databaseLink
- String
Der Link der Datenbank, in der der Benutzer erstellt werden soll. z.B. dbs/db_rid/
- options
- RequestOptions
(Optional) Die Anforderungsoptionen für die Anforderung.
Gibt zurück
Ein Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt, der das erstellte User Objekt enthält.
Ausnahmen
Wenn entweder databaseLink oder user nicht festgelegt ist.
Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions, um die tatsächlichen Ausnahmen zu finden.
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 eines Dokuments erhalten, sind:
| StatusCode | Ausnahmegrund |
|---|---|
| 400 | BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte. |
| 403 | Verboten: Sie haben Ihr Kontingent an Benutzerobjekten für diese Datenbank erreicht. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen. |
| 409 | Konflikt: Dies bedeutet, dass eine User mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist. |
Beispiele
//Create a new user called joeBloggs in the specified database
User user = await client.CreateUserAsync(databaseLink, new User { Id = "joeBloggs" });
Weitere Informationen
Gilt für:
CreateUserAsync(Uri, User, RequestOptions)
Erstellt einen Benutzer als asychronen Vorgang im Azure Cosmos DB-Dienst.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> CreateUserAsync (Uri databaseUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);abstract member CreateUserAsync : Uri * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>Public Function CreateUserAsync (databaseUri As Uri, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))Parameter
- databaseUri
- Uri
Der URI der Datenbank, in der der Benutzer erstellt werden soll.
- options
- RequestOptions
(Optional) Der RequestOptions für die Anforderung.
Gibt zurück
Das Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Gilt für:
Azure SDK for .NET