IDocumentClient.ReplaceUserAsync Methode

Definition

Namespace:

Microsoft.Azure.Documents

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 einen User im Azure Cosmos DB-Dienst als asynchronen Vorgang.
ReplaceUserAsync(Uri, User, RequestOptions)	Ersetzt einen Benutzer als asynchronen Vorgang im Azure Cosmos DB-Dienst.

ReplaceUserAsync(User, RequestOptions)

Ersetzt einen User im Azure Cosmos DB-Dienst als asynchronen 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>>

Public Function ReplaceUserAsync (user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))

Parameter

user

User

Die aktualisierte User , um die vorhandene Ressource durch zu ersetzen.

options

RequestOptions

(Optional) Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<User>>

Ein System.Threading.Tasks mit einem ResourceResponse<TResource> , das ein umschließt, User das den aktualisierten Ressourcendatensatz enthält.

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

StatusCode	Grund für die Ausnahme
404	NotFound: 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

• User
• RequestOptions
• ResourceResponse<TResource>
• Task

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>>

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

(Optional) Die RequestOptions für die Anforderung.

Gibt zurück

Task<ResourceResponse<User>>

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