Freigeben über


Database.CreateUserAsync(String, RequestOptions, CancellationToken) Methode

Definition

Erstellt einen Benutzer als asynchronen Vorgang im Azure Cosmos-Dienst.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.UserResponse> CreateUserAsync (string id, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateUserAsync : string * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.UserResponse>
Public MustOverride Function CreateUserAsync (id As String, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of UserResponse)

Parameter

id
String

Die Cosmos-Benutzer-ID

requestOptions
RequestOptions

(Optional) Die Optionen für die Benutzeranforderung.

cancellationToken
CancellationToken

(Optional) CancellationToken stellt den Anforderungsabbruch dar.

Gibt zurück

Eine Task , die ein UserResponse enthält, das einen UserProperties umschließt, der den gelesenen Ressourcendatensatz enthält.

Ausnahmen

Wenn id nicht festgelegt ist.

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 Benutzers erhalten können, sind:

StatusCodeGrund für die Ausnahme
400BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung ein Fehler aufgetreten ist. Es ist wahrscheinlich, dass für den neuen Benutzer keine ID angegeben wurde.
409Konflikt: Dies bedeutet, dass ein UserProperties mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.

Beispiele

UserResponse response = await this.cosmosDatabase.CreateUserAsync(Guid.NewGuid().ToString());

Gilt für: