Freigeben über

DocumentClient.ReplaceUserAsync 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

Überlädt

ReplaceUserAsync(User, RequestOptions)

Ersetzt ein User im Azure Cosmos DB-Dienst als asynchroner Vorgang.
ReplaceUserAsync(Uri, User, RequestOptions)

Ersetzt einen Benutzer als asynchronen Vorgang im Azure Cosmos DB-Dienst.

ReplaceUserAsync(User, RequestOptions)

Ersetzt ein User im Azure Cosmos DB-Dienst als asynchroner Vorgang.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> ReplaceUserAsync (Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member ReplaceUserAsync : Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
override this.ReplaceUserAsync : Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
Public Function ReplaceUserAsync (user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))

Parameter

user
User

Die wurde aktualisiert User , um die vorhandene Ressource durch zu ersetzen.

options
RequestOptions

(Optional) Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<User>>

Eine System.Threading.Tasks , die ein ResourceResponse<TResource> enthält, das einen User umschließt, der den aktualisierten Ressourcendatensatz enthält.

Implementiert

ReplaceUserAsync(User, RequestOptions)

Ausnahmen

ArgumentNullException

Wenn user nicht festgelegt ist.

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 eines Dokuments erhalten, sind:

StatusCodeAusnahmegrund
404NotFound– Dies bedeutet, dass die Ressource, die Sie löschen möchten, nicht vorhanden war.

Beispiele

//Fetch the resource to be updated
User user = client.CreateUserQuery(usersLink)
                         .Where(r => r.Id == "user id")
                         .AsEnumerable()
                         .SingleOrDefault();

//Change the user mode to All
user.Id = "some new method";

//Now persist these changes to the database by replacing the original resource
User updated = await client.ReplaceUserAsync(user);

Weitere Informationen

Gilt für:

ReplaceUserAsync(Uri, User, RequestOptions)

Ersetzt einen Benutzer als asynchronen Vorgang im Azure Cosmos DB-Dienst.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> ReplaceUserAsync (Uri userUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member ReplaceUserAsync : Uri * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
override this.ReplaceUserAsync : 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 ReplaceUserAsync (userUri As Uri, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))

Parameter

userUri
Uri

der URI für den zu aktualisierenden Benutzer.

user
User

der aktualisierte Benutzer.

options
RequestOptions

Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<User>>

Das Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.

Implementiert

ReplaceUserAsync(Uri, User, RequestOptions)

Gilt für: