IDocumentClient.CreateDocumentCollectionAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Documents

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

CreateDocumentCollectionAsync(String, DocumentCollection, RequestOptions)	Crée une collection en tant qu’opération asychrone dans le service Azure Cosmos DB.
CreateDocumentCollectionAsync(Uri, DocumentCollection, RequestOptions)	Crée une collection en tant qu’opération asychrone dans le service Azure Cosmos DB.

CreateDocumentCollectionAsync(String, DocumentCollection, RequestOptions)

Crée une collection 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.DocumentCollection>> CreateDocumentCollectionAsync (string databaseLink, Microsoft.Azure.Documents.DocumentCollection documentCollection, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateDocumentCollectionAsync : string * Microsoft.Azure.Documents.DocumentCollection * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>>

Public Function CreateDocumentCollectionAsync (databaseLink As String, documentCollection As DocumentCollection, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of DocumentCollection))

Paramètres

databaseLink

String

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

documentCollection

DocumentCollection

Objet DocumentCollection.

options

RequestOptions

(Facultatif) Tous les éléments RequestOptions que vous souhaitez fournir lors de la création d’une collection. Par exemple, RequestOptions.OfferThroughput = 400.

Retours

Task<ResourceResponse<DocumentCollection>>

DocumentCollection qui a été créé dans un Task objet représentant la réponse du service pour l’opération asynchrone.

Exceptions

ArgumentNullException

Si ou databaseLinkdocumentCollection 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’une collection :

StatusCode	Raison de l’exception
400	BadRequest : cela signifie qu’un problème s’est produit avec la demande fournie. Il est probable qu’aucun ID n’a été fourni pour la nouvelle collection.
403	Interdit : cela signifie que vous avez tenté de dépasser votre quota pour les collections. Contactez le support technique pour augmenter ce quota.
409	Conflit : cela signifie qu’un DocumentCollection avec un ID correspondant à l’ID que vous avez fourni existait déjà.

Exemples

using (IDocumentClient client = new DocumentClient(new Uri("service endpoint"), "auth key"))
{
    //Create a new collection with an OfferThroughput set to 10000
    //Not passing in RequestOptions.OfferThroughput will result in a collection with the default OfferThroughput set.
    DocumentCollection coll = await client.CreateDocumentCollectionAsync(databaseLink,
        new DocumentCollection { Id = "My Collection" },
        new RequestOptions { OfferThroughput = 10000} );
}

Voir aussi

• RequestOptions
• ResourceResponse<TResource>
• Task
• DocumentCollection
• OfferV2

CreateDocumentCollectionAsync(Uri, DocumentCollection, RequestOptions)

Crée une collection 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.DocumentCollection>> CreateDocumentCollectionAsync (Uri databaseUri, Microsoft.Azure.Documents.DocumentCollection documentCollection, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreateDocumentCollectionAsync : Uri * Microsoft.Azure.Documents.DocumentCollection * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>>

Public Function CreateDocumentCollectionAsync (databaseUri As Uri, documentCollection As DocumentCollection, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of DocumentCollection))

Paramètres

databaseUri

Uri

URI de la base de données dans laquelle créer la collection.

documentCollection

DocumentCollection

Objet DocumentCollection.

options

RequestOptions

(Facultatif) RequestOptions pour la demande.

Retours

Task<ResourceResponse<DocumentCollection>>

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