MongoCollectionBase<TDocument>.CountDocuments Method (IClientSessionHandle, FilterDefinition<TDocument>, 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.20.0+ee01960089f28ea1b501690df5fc9f6318a70242

Syntax

Copy

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

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

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

Parameters

session: Type: MongoDB.Driver.IClientSessionHandle
The session.
filter: Type: MongoDB.Driver.FilterDefinition<TDocument>
The filter.
options (Optional): Type: MongoDB.Driver.CountOptions
The options.
cancellationToken (Optional): Type: System.Threading.CancellationToken
The cancellation token.

Return Value

Type: Int64
The number of documents in the collection.

Implements

IMongoCollection<TDocument>.CountDocuments(IClientSessionHandle, FilterDefinition<TDocument>, 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

MongoCollectionBase<TDocument> Class

CountDocuments Overload

MongoDB.Driver Namespace