MongoCollectionBaseTDocumentCountDocuments Method (FilterDefinitionTDocument, CountOptions, CancellationToken)

Counts the number of documents in the collection. For a fast estimate of the total documents in a collection see EstimatedDocumentCount(EstimatedDocumentCountOptions, CancellationToken).

Namespace: MongoDB.Driver
Assembly: MongoDB.Driver (in MongoDB.Driver.dll) Version: 2.16.0+eeafbea0921243a5868b81984e1083a07c1f75bc

Syntax

Copy

public virtual long CountDocuments(
	FilterDefinition<TDocument> filter,
	CountOptions options = null,
	CancellationToken cancellationToken = default
)

Public Overridable Function CountDocuments ( 
	filter As FilterDefinition(Of TDocument),
	Optional options As CountOptions = Nothing,
	Optional cancellationToken As CancellationToken = Nothing
) As Long

abstract CountDocuments : 
        filter : FilterDefinition<'TDocument> * 
        ?options : CountOptions * 
        ?cancellationToken : CancellationToken 
(* Defaults:
        let _options = defaultArg options null
        let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> int64 
override CountDocuments : 
        filter : FilterDefinition<'TDocument> * 
        ?options : CountOptions * 
        ?cancellationToken : CancellationToken 
(* Defaults:
        let _options = defaultArg options null
        let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> int64

Parameters

filter: Type: MongoDB.DriverFilterDefinitionTDocument
The filter.
options (Optional): Type: MongoDB.DriverCountOptions
The options.
cancellationToken (Optional): Type: System.ThreadingCancellationToken
The cancellation token.

Return Value

Type: Int64
The number of documents in the collection.

Implements

IMongoCollectionTDocumentCountDocuments(FilterDefinitionTDocument, CountOptions, CancellationToken)

Remarks

Note: when migrating from Count to CountDocuments the following query operations must be replaced:

Copy

+-------------+--------------------------------+
| Operator    | Replacement                    |
+=============+================================+
| $where      |  $expr                         |
+-------------+--------------------------------+
| $near       |  $geoWithin with $center       |
+-------------+--------------------------------+
| $nearSphere |  $geoWithin with $centerSphere |
+-------------+--------------------------------+

Reference

MongoCollectionBaseTDocument Class

CountDocuments Overload

MongoDB.Driver Namespace