DocumentClient.CreateUserAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Documents.Client

Assemblys:

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

Paquets:

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

Surcharges

CreateUserAsync(String, User, RequestOptions)	Crée un objet utilisateur en tant qu’opération asychrone dans le service Azure Cosmos DB.
CreateUserAsync(Uri, User, RequestOptions)	Crée un utilisateur en tant qu’opération asychrone dans le service Azure Cosmos DB.

CreateUserAsync(String, User, RequestOptions)

Crée un objet utilisateur en tant qu’opération asychrone dans le service 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))

Paramètres

databaseLink

String

Lien de la base de données dans laquelle créer l’utilisateur. Par exemple, dbs/db_rid/

user

User

Objet User à créer.

options

RequestOptions

(Facultatif) Options de demande pour la demande.

Retours

Task<ResourceResponse<User>>

Objet de tâche représentant la réponse de service pour l’opération asynchrone qui contient l’objet créé User .

Implémente

CreateUserAsync(String, User, RequestOptions)

Exceptions

ArgumentNullException

Si ou databaseLinkuser n’est pas défini.

AggregateException

Représente une consolidation des échecs qui se sont produits pendant le traitement asynchrone. Recherchez la ou les exceptions réelles dans InnerExceptions

DocumentClientException

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un document :

StatusCode	Raison de l’exception
400	BadRequest : cela signifie qu’il y a eu un problème avec la demande fournie.
403	Interdit : vous avez atteint votre quota d’objets utilisateur pour cette base de données. Contactez le support technique pour augmenter ce quota.
409	Conflit : cela signifie qu’un User avec un ID correspondant à l’ID que vous avez fourni existait déjà.

Exemples

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

Voir aussi

• User
• RequestOptions
• ResourceResponse<TResource>
• Task

CreateUserAsync(Uri, User, RequestOptions)

Crée un utilisateur en tant qu’opération asychrone dans le service 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))

Paramètres

databaseUri

Uri

URI de la base de données dans laquelle créer l’utilisateur.

user

User

l’objet Microsoft.Azure.Documents.User.

options

RequestOptions

Options de demande pour la demande.

Retours

Task<ResourceResponse<User>>

Objet de tâche représentant la réponse du service pour l’opération asynchrone.

Implémente

CreateUserAsync(Uri, User, RequestOptions)