IDocumentWriter<TDocument>.CreateDocumentAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a document provided at Document.
public:
System::Threading::Tasks::Task<System::Cloud::DocumentDb::IDatabaseResponse<TDocument> ^> ^ CreateDocumentAsync(System::Cloud::DocumentDb::RequestOptions<TDocument> ^ options, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Cloud.DocumentDb.IDatabaseResponse<TDocument>> CreateDocumentAsync(System.Cloud.DocumentDb.RequestOptions<TDocument> options, System.Threading.CancellationToken cancellationToken);abstract member CreateDocumentAsync : System.Cloud.DocumentDb.RequestOptions<'Document> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Cloud.DocumentDb.IDatabaseResponse<'Document>>Public Function CreateDocumentAsync (options As RequestOptions(Of TDocument), cancellationToken As CancellationToken) As Task(Of IDatabaseResponse(Of TDocument))Parameters
- options
- RequestOptions<TDocument>
The request options.
- cancellationToken
- CancellationToken
The token represents request cancellation.
Returns
A Task containing a IDatabaseResponse<T> that wraps the created document.
Exceptions
Thrown when an error occurred on a client side. For example on a bad request, permissions error or client timeout.
Thrown when an error occurred on a database server side, including internal server error.
Thrown when a request failed but can be retried. This includes throttling and server not available cases.
A generic exception thrown in all other not covered above cases.
Remarks
The request will fail if an item already exists.
