IDocumentClient.CreateDocumentCollectionIfNotExistsAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
CreateDocumentCollectionIfNotExistsAsync(String, DocumentCollection, RequestOptions) |
Erstellt (falls nicht vorhanden) oder ruft (sofern bereits vorhanden) eine Sammlung als asychronen Vorgang im Azure Cosmos DB-Dienst ab. Sie können den status Code aus der Antwort überprüfen, um festzustellen, ob die Sammlung neu erstellt wurde (201) oder ob eine vorhandene Sammlung zurückgegeben wurde (200). |
CreateDocumentCollectionIfNotExistsAsync(Uri, DocumentCollection, RequestOptions) |
Erstellt (falls nicht vorhanden) oder ruft (sofern bereits vorhanden) eine Sammlung als asychronen Vorgang im Azure Cosmos DB-Dienst ab. |
CreateDocumentCollectionIfNotExistsAsync(String, DocumentCollection, RequestOptions)
Erstellt (falls nicht vorhanden) oder ruft (sofern bereits vorhanden) eine Sammlung als asychronen Vorgang im Azure Cosmos DB-Dienst ab. Sie können den status Code aus der Antwort überprüfen, um festzustellen, ob die Sammlung neu erstellt wurde (201) oder ob eine vorhandene Sammlung zurückgegeben wurde (200).
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>> CreateDocumentCollectionIfNotExistsAsync (string databaseLink, Microsoft.Azure.Documents.DocumentCollection documentCollection, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateDocumentCollectionIfNotExistsAsync : 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 CreateDocumentCollectionIfNotExistsAsync (databaseLink As String, documentCollection As DocumentCollection, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of DocumentCollection))
Parameter
- databaseLink
- String
Der Link der Datenbank, in der die Auflistung erstellt werden soll. Beispiel: dbs/db_rid/.
- documentCollection
- DocumentCollection
Das DocumentCollection-Objekt.
- options
- RequestOptions
(Optional) Alle, RequestOptions die Sie beim Erstellen einer Sammlung angeben möchten. Z.B. RequestOptions.OfferThroughput = 400.
Gibt zurück
Das DocumentCollection erstellt wurde, das in einem Task Objekt enthalten ist, das die Dienstantwort für den asynchronen Vorgang darstellt.
Ausnahmen
Wenn entweder databaseLink
oder documentCollection
nicht festgelegt ist.
Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.
Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Erstellen einer DocumentCollection erhalten können, sind:
StatusCode | Ausnahmegrund |
---|---|
400 | BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte. Es ist wahrscheinlich, dass für die neue Auflistung keine ID angegeben wurde. |
403 | Verboten: Dies bedeutet, dass Sie versucht haben, Ihr Kontingent für Sammlungen zu überschreiten. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen. |
Beispiele
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.CreateDocumentCollectionIfNotExistsAsync(databaseLink,
new DocumentCollection { Id = "My Collection" },
new RequestOptions { OfferThroughput = 10000} );
}
Weitere Informationen
Gilt für:
CreateDocumentCollectionIfNotExistsAsync(Uri, DocumentCollection, RequestOptions)
Erstellt (falls nicht vorhanden) oder ruft (sofern bereits vorhanden) eine Sammlung als asychronen Vorgang im Azure Cosmos DB-Dienst ab.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>> CreateDocumentCollectionIfNotExistsAsync (Uri databaseUri, Microsoft.Azure.Documents.DocumentCollection documentCollection, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateDocumentCollectionIfNotExistsAsync : 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 CreateDocumentCollectionIfNotExistsAsync (databaseUri As Uri, documentCollection As DocumentCollection, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of DocumentCollection))
Parameter
- databaseUri
- Uri
der URI der Datenbank, in der die Auflistung erstellt werden soll.
- documentCollection
- DocumentCollection
Das DocumentCollection-Objekt.
- options
- RequestOptions
(Optional) Alle, RequestOptions die Sie beim Erstellen einer Sammlung angeben möchten. Z.B. RequestOptions.OfferThroughput = 400.
Gibt zurück
Das DocumentCollection erstellt wurde, das in einem Task Objekt enthalten ist, das die Dienstantwort für den asynchronen Vorgang darstellt.
Gilt für:
Azure SDK for .NET