This is the general availability release for the 2.25.0 version of the driver.

NOTICE: MongoDB 3.6 reached end-of-life in April 2021. The .NET/C# Driver will be removing support for MongoDB 3.6 in an upcoming release.

The main new features in 2.25.0 include:

• Support of MONGODB-OIDC Authentication mechanism - CSHARP-4448
• MONGODB-OIDC: Automatic token acquisition for Azure Identity Provider - CSHARP-4474
• Improved error message when no matching constructor found - CSHARP-5007
• Driver Container and Kubernetes Awareness - CSHARP-4718
• Logging of executed MQL for a LINQ query - CSHARP-4684
• Allow custom service names with srvServiceName URI option - CSHARP-3745
• BulkWrite enumerates requests argument only once - CSHARP-1378
• Support of Range Explicit Encryption - CSHARP-5009
• Multiple bug fixes and improvements.

The full list of issues resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

.NET Driver Version 2.24.0 Release Notes

This is the general availability release for the 2.24.0 version of the driver.

The main new features in 2.24.0 include:

• New DistinctMany method in IMongoCollection
• Support for latest $dateFromString optional arguments
• ExceededTimeLimit server error is now retryable for reads as well as writes
• Support sort by score in $search stage
• New custom method to test if a field exists or is missing in LINQ (Mql.Exists, Mql.IsMissing, Mql.IsNullOrMissing)
• Enable TLS 1.3 support
• Fix a GridFS error when attempting to upload a GridFS file with a duplicate id and the new file is smaller than the original file
• Add support for Atlas Search $in operator
• Add support for IComparable CompareTo method in LINQ queries
• Add VectorSearchScore builder for $vectorSearch stage
• Update libmongocrypt package version
• Support for nested AsQueryable in LINQ queries (not a common use case but legal, primarily added for use by the EF Core Provider)
• Updated authentication to occur over OP_MSG on supporting servers to improve MongoDB Atlas Serverless compatibility
• Use polling monitoring when running within a FaaS environment such as AWS Lambda
• Fixed segfault in Kerberos (libgssapi) on newer Linux distros

An online version of these release notes is available here.

The full list of issues resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

This is a patch release that addresses some issues reported since 2.23.1 was released.

An online version of these release notes is available here.

The list of JIRA tickets resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

Upgrading

There are no known backwards breaking changes in this release.

This is a patch release that addresses some issues reported since 2.23.0 was released.

An online version of these release notes is available here.

The list of JIRA tickets resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

Upgrading

There are no known backwards breaking changes in this release.

This is the general availability release for the 2.23.0 version of the driver.

The main new features in 2.23.0 include:

• General driver bug fixes and improvements
• Support for bitwise operators in aggregation pipeline - CSHARP-4486
• Support for $out to Time-series collections - CSHARP-4706
• ChangeStreamSplitLargeEvent aggregation stage added - CSHARP-4633
• LINQ3 bug fixes and improvements
• Additional logging messages

An online version of these release notes is available here.

The full list of issues resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

.NET Driver Version 2.22.0 Release Notes

This is the general availability release for the 2.22.0 version of the driver.

The main new features in 2.22.0 include:

• LINQ3 bug fixes and improvements
• Support for $set aggregation stage
• Added synonym support for Atlas Search
• Support for $vectorSearch aggregation stage
• Reduced memory allocations when using encryption
• Additional logging messages

An online version of these release notes is available here.

The full list of issues resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

.NET Driver Version 2.21.0 Release Notes

This is the general availability release for the 2.21.0 version of the driver.

The main new features in 2.21.0 include:

• LINQ3 bug fixes and improvements
• Atlas Search sort, tracking, score details options added
• Atlas Search embeddedDocuments operator support
• Atlas Search index mangement API added
• Anonymous types added to default AllowedTypes in ObjectSerializer

Atlas Search minor breaking change

All Render methods in Atlas Search builders have a new signature:

Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry)

Changed to

Render(SearchDefinitionRenderContext<TDocument> renderContext)

An online version of these release notes is available here.

The full list of issues resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

.NET Driver Version 2.20.0 Release Notes

This is the general availability release for the 2.20.0 version of the driver.

The main new features in 2.20.0 include:

• Support for MongoDB server version 7.0.0
• Support for equality query types in Queryable Encryption GA
• LINQ3 bug fixes and improvements
• Serialization bug fixes and improvements
• Logging improvements

An online version of these release notes is available here.

The full list of issues resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

.NET Driver Version 2.19.2 Release Notes

This is a patch release that addresses some issues reported since 2.19.1 was released.

An online version of these release notes is available here.

The list of JIRA tickets resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

Upgrading

There are no known backwards breaking changes in this release.

.NET Driver Version 2.19.1 Release Notes

This is a patch release that addresses some issues reported since 2.19.0 was released.

An online version of these release notes is available here.

The list of JIRA tickets resolved in this release is available at CSHARP JIRA project.

Documentation on the .NET driver can be found here.

Upgrading

There are no known backwards breaking changes in this release.