IDocumentClient.UpsertUserAsync 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
| UpsertUserAsync(String, User, RequestOptions) |
Upsert eine Berechtigung für ein Benutzerobjekt im Azure Cosmos DB-Dienst als asychronen Vorgang. |
| UpsertUserAsync(Uri, User, RequestOptions) |
Upsert einen Benutzer als asychroner Vorgang im Azure Cosmos DB-Dienst. |
UpsertUserAsync(String, User, RequestOptions)
Upsert eine Berechtigung für ein Benutzerobjekt im Azure Cosmos DB-Dienst als asychronen Vorgang.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> UpsertUserAsync (string databaseLink, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);abstract member UpsertUserAsync : 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 UpsertUserAsync (databaseLink As String, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))Parameter
- databaseLink
- String
Der Link der Datenbank zum Upsertieren des Benutzers. 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 upsertierte User Objekt enthält.
Ausnahmen
Wenn oder databaseLinkuser nicht festgelegt ist.
Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.
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 können, sind:
| StatusCode | Grund für die Ausnahme |
|---|---|
| 400 | BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung ein Fehler aufgetreten ist. |
| 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 ein User mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist. |
Beispiele
//Upsert a new user called joeBloggs in the specified database
User user = await client.UpsertUserAsync(databaseLink, new User { Id = "joeBloggs" });
Weitere Informationen
Gilt für:
UpsertUserAsync(Uri, User, RequestOptions)
Upsert einen Benutzer als asychroner Vorgang im Azure Cosmos DB-Dienst.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> UpsertUserAsync (Uri databaseUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);abstract member UpsertUserAsync : 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 UpsertUserAsync (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 ein Upsert für den Benutzer ausgeführt werden soll.
- options
- RequestOptions
(Optional) Die RequestOptions für die Anforderung.
Gibt zurück
Das Aufgabenobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.
Gilt für:
Azure SDK for .NET