DocumentClient.ReplaceUserAsync Método

Definição

Namespace:

Microsoft.Azure.Documents.Client

Assemblies:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Pacotes:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Sobrecargas

ReplaceUserAsync(User, RequestOptions)	Substitui um User no serviço do Azure Cosmos DB como uma operação assíncrona.
ReplaceUserAsync(Uri, User, RequestOptions)	Substitui um usuário como uma operação assíncrona no serviço do Azure Cosmos DB.

ReplaceUserAsync(User, RequestOptions)

Substitui um User no serviço do Azure Cosmos DB como uma operação assíncrona.

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

Parâmetros

user

User

O atualizado User para substituir o recurso existente.

options

RequestOptions

(Opcional) As opções de solicitação para a solicitação.

Retornos

Task<ResourceResponse<User>>

Um System.Threading.Tasks que contém um ResourceResponse<TResource> que encapsula um User que contém o registro de recurso atualizado.

Implementações

ReplaceUserAsync(User, RequestOptions)

Exceções

ArgumentNullException

Se user não estiver definido.

DocumentClientException

Essa exceção pode encapsular muitos tipos diferentes de erros. Para determinar o erro específico, sempre examine a propriedade StatusCode. Alguns códigos comuns que você pode obter ao criar um Documento são:

StatusCode	Motivo da exceção
404	NotFound - Isso significa que o recurso que você tentou excluir não existia.

Exemplos

//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);

Confira também

• ResourceResponse<TResource>
• Task
• User
• RequestOptions

ReplaceUserAsync(Uri, User, RequestOptions)

Substitui um usuário como uma operação assíncrona no serviço do Azure Cosmos DB.

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

Parâmetros

userUri

Uri

o URI para o usuário a ser atualizado.

user

User

o usuário atualizado.

options

RequestOptions

As opções de solicitação para a solicitação.

Retornos

Task<ResourceResponse<User>>

O objeto de tarefa que representa a resposta de serviço para a operação assíncrona.

Implementações

ReplaceUserAsync(Uri, User, RequestOptions)