IDocumentClient.CreateUserAsync Método

Definição

Namespace:

Microsoft.Azure.Documents

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

CreateUserAsync(String, User, RequestOptions)	Cria um objeto de usuário como uma operação assíncrona no serviço do Azure Cosmos DB.
CreateUserAsync(Uri, User, RequestOptions)	Cria um usuário como uma operação assíncrona no serviço do Azure Cosmos DB.

CreateUserAsync(String, User, RequestOptions)

Cria um objeto de 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>> CreateUserAsync (string databaseLink, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateUserAsync : 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 CreateUserAsync (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 no qual o usuário será criado. Por exemplo, dbs/db_rid/

user

User

O User objeto a ser criado.

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 criado User .

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

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

Confira também

• User
• RequestOptions
• ResourceResponse<TResource>
• Task

CreateUserAsync(Uri, User, RequestOptions)

Cria 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>> CreateUserAsync (Uri databaseUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateUserAsync : 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 CreateUserAsync (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 no qual criar o usuário.

user

User

O objeto User.

options

RequestOptions

(Opcional) O RequestOptions 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.