MongoCollectionBaseTDocumentCountDocuments Method (IClientSessionHandle, 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.11.0+cb27a82ea70620ad1acad8058809be8302ae4f2a

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.DriverIClientSessionHandle
The session.
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(IClientSessionHandle, 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