IAsyncCursorExtensions.Single<TDocument> Method

Returns the only document of a cursor. This method throws an exception if the cursor does not contain exactly one document.

Namespace: MongoDB.Driver
Assembly: MongoDB.Driver.Core (in MongoDB.Driver.Core.dll) Version: 2.5.0+57.Branch.master.Sha.6a4e00a2d91090c65a9b11364b9ebfdb9c7da076

Syntax

Copy

public static TDocument Single<TDocument>(
	this IAsyncCursor<TDocument> cursor,
	CancellationToken cancellationToken = null
)

<ExtensionAttribute>
Public Shared Function Single(Of TDocument) ( 
	cursor As IAsyncCursor(Of TDocument),
	Optional cancellationToken As CancellationToken = Nothing
) As TDocument

[<ExtensionAttribute>]
static member Single : 
        cursor : IAsyncCursor<'TDocument> * 
        ?cancellationToken : CancellationToken 
(* Defaults:
        let _cancellationToken = defaultArg cancellationToken null
*)
-> 'TDocument

Parameters

cursor: Type: MongoDB.Driver.IAsyncCursor<TDocument>
The cursor.
cancellationToken (Optional): Type: System.Threading.CancellationToken
The cancellation token.

Type Parameters

TDocument: The type of the document.

Return Value

Type: TDocument
The only document of a cursor.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IAsyncCursor<TDocument>. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Reference

IAsyncCursorExtensions Class