DocumentClient.CreateUserAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Documents.Client

Ensamblados:

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

Paquetes:

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

Sobrecargas

CreateUserAsync(String, User, RequestOptions)	Crea un objeto de usuario como una operación asincrónica en el servicio Azure Cosmos DB.
CreateUserAsync(Uri, User, RequestOptions)	Crea un usuario como una operación asincrónica en el servicio Azure Cosmos DB.

CreateUserAsync(String, User, RequestOptions)

Crea un objeto de usuario como una operación asincrónica en el servicio 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>>
override this.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

Vínculo de la base de datos en la que se va a crear el usuario. Por ejemplo, dbs/db_rid/

user

User

Objeto User que se va a crear.

options

RequestOptions

(Opcional) Las opciones de solicitud de la solicitud.

Devoluciones

Task<ResourceResponse<User>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica que contiene el objeto creado User .

Implementaciones

CreateUserAsync(String, User, RequestOptions)

Excepciones

ArgumentNullException

Si se establece o databaseLinkuser no.

AggregateException

Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.

DocumentClientException

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un documento son:

StatusCode	Motivo de la excepción
400	BadRequest: esto significa que algo estaba mal con la solicitud proporcionada.
403	Prohibido: ha alcanzado la cuota de objetos de usuario para esta base de datos. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409	Conflicto: esto significa que un User elemento con un identificador que coincide con el identificador que proporcionó ya existía.

Ejemplos

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

Consulte también

• ResourceResponse<TResource>
• Task
• User
• RequestOptions

CreateUserAsync(Uri, User, RequestOptions)

Crea un usuario como una operación asincrónica en el servicio 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>>
override this.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

el URI de la base de datos en el que se va a crear el usuario.

user

User

El objeto Microsoft.Azure.Documents.User.

options

RequestOptions

Las opciones de solicitud de la solicitud.

Devoluciones

Task<ResourceResponse<User>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Implementaciones

CreateUserAsync(Uri, User, RequestOptions)