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

UpsertUserAsync(String, User, RequestOptions)	Insere uma permissão em um objeto de usuário no serviço do Azure Cosmos DB como uma operação assíncrona.
UpsertUserAsync(Uri, User, RequestOptions)	Faz upserts de um usuário como uma operação assíncrona no serviço do Azure Cosmos DB.

UpsertUserAsync(String, User, RequestOptions)

Insere uma permissão em um objeto de usuário 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>> 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>>
override this.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))

Parâmetros

databaseLink

String

O link do banco de dados para upsert do usuário. Por exemplo, dbs/db_rid/

user

User

O User objeto a ser upsert.

options

RequestOptions

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

Retornos

Task<ResourceResponse<User>>

Um objeto de tarefa que representa a resposta do serviço para a operação assíncrona que contém o objeto upserted User .

Implementações

UpsertUserAsync(String, User, RequestOptions)

Exceções

ArgumentNullException

Se ou databaseLinkuser não estiver definido.

AggregateException

Representa uma consolidação de falhas que ocorreram durante o processamento assíncrono. Procure dentro de InnerExceptions para encontrar as exceções reais

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
400	BadRequest - Isso significa que algo estava errado com a solicitação fornecida.
403	Proibido – você atingiu sua cota de objetos de usuário para este banco de dados. Entre em contato com o suporte para aumentar essa cota.
409	Conflito – isso significa que um com uma User ID correspondente à ID que você forneceu já existia.

Exemplos

//Upsert a new user called joeBloggs in the specified database
User user = await client.UpsertUserAsync(databaseLink, new User { Id = "joeBloggs" });

Confira também

• User
• RequestOptions
• ResourceResponse<TResource>
• Task

UpsertUserAsync(Uri, User, RequestOptions)

Faz upserts de 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>> 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>>
override this.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))

Parâmetros

databaseUri

Uri

o URI do banco de dados para upsert o usuário.

user

User

o objeto Microsoft.Azure.Documents.User.

options

RequestOptions

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

Retornos

Task<ResourceResponse<User>>

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

Implementações

UpsertUserAsync(Uri, User, RequestOptions)