.NET Driver Version 3.1.0 Release Notes

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

The main new features in 3.1.0 include:

• Support token field type and array field expressions with Atlas Search builders for equals operator - CSHARP-4926
• Support SearchIndexType option when creating Atlas Search indexes - CSHARP-4960
• Support for valid SRV hostnames with less than 3 parts - CSHARP-5200
• Support for search sequential pagination - CSHARP-5420
• Support for Mql methods: Exists, IsMissing and IsNullOrMissing in filters when possible - CSHARP-5427
• Support for Exact Vector Search (ENN) - CSHARP-5212
• Allow sort option to be supplied to update commands (updateOne, etc.) - CSHARP-5201
• Disabled TLS renegotiation when possible - CSHARP-2843
• Fix a bug in discriminator convention inheritance - CSHARP-5349
• New Serializers for ImmutableArray and other immutable collections - CSHARP-5335
• Minor 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 3.0.0 Release Notes

The MongoDB .NET/C# driver team is pleased to announce our v3.0.0 release! The 3.0.0 release incorporates many user-requested fixes and improvements that have been deferred as backwards-incompatible, as well as internal improvements to pay down technical debt and improve maintainability. Additional major changes include removal of a large area of the public API (mainly from MongoDB.Driver.Core), which was not intended for public use. Removed APIs are marked as deprecated in v2.30.0 version.
For all the breaking changes and for the upgrade guidlines, please see the upgrade guide.

The main new features in 3.0.0 include:

• CSHARP-4904: Adding .NET 6 target framework
• CSHARP-4916: Removing .NETSTANDARD 2.0 target framework
• CSHARP-5193: Removing LINQ2 provider
• CSHARP-5233: Remove IMongoQueryable interface
• CSHARP-4145: Improved Bulk Write API
• CSHARP-4763: Client side projections with Find and Select
• CSHARP-3899: Removing MongoDB.Driver.Legacy package
• CSHARP-4917: Removing MongoDB.Driver.Core package and various non-user-facing APIs (see v2.30.0 for deprecation messages)
• CSHARP-5232: Embedding MongoDB.Driver.GridFS package into MongoDB.Driver package
• CSHARP-4912: Refactoring the Client Side field level description to an optional MongoDB.Driver.Encryption package. MongoDB.Libmongocrypt package is not in use anymore and will not get any further updates
• CSHARP-4911: Refactoring the AWS authentication to an optional MongoDB.Driver.Authentication.AWS package
• CSHARP-5291: Removing MONGODB-CR support
• CSHARP-5263: Removing support for TLS1.0 and 1.1
• CSHARP-2930: Changing default GUID serialization mode and removing GuidRepresentationMode
• CSHARP-3717: Adding DateOnly/TimeOnly support

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.30.0 Release Notes

This is the general availability release for the 2.30.0 version of the driver. Version 2.30.0 of the driver is the last scheduled 2.x release. Further driver development will continue in 3.x versions.

Version 2.30.0 does not introduce new features or bug fixes. The single purpose of 2.30 is to ease the migration to 3.x by marking the public API that was removed in 3.0 as obsolete.

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.29.0 Release Notes

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

Version 2.29.0 of the driver has been tested against MongoDB Server version 8.0 and adds support for the following new features in server version 8.0:

• Support for v2 of the Queryable Encryption range protocol - CSHARP-4959
• Range indexes for Queryable Encryption are now GA - CSHARP-5057

The following server 8.0 features are not yet supported and will be supported in a later release of the driver:

• Improved Bulk Write API - CSHARP-4145
• Update Sort option - CSHARP-5201

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.28.0 Release Notes

This is the general availability release for the 2.28.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.28.0 include:

• Provide Strong-Named Assemblies - CSHARP-1276
• Support additional numeric conversions involving Nullable - CSHARP-5180
• CSFLE/QE KMIP support "delegated" protocol - CSHARP-4941

Bug fixes:

• Verify that operands to numeric operators in LINQ expressions are represented as numbers on the server - CSHARP-4985
• IReadOnlyDictionary indexer access fails to translate in v3 - CSHARP-5171
• Projection Expressions Fail to Deserialize Data Correctly - CSHARP-5162
• Enum conversion within IQueryable fails with Expression not supported exception - CSHARP-5043
• IMongoCollection.AsQueryable().Select() fails for array type (regression) - CSHARP-4957

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.27.0 Release Notes

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

The main new features in 2.27.0 include:

• Support $sample aggregation operator - CSHARP-2659
• Implement Equals method for serializers in LINQ3 - CSHARP-3315
• Avoid Appending Write/Read Concern in Atlas Search Index Helper Commands - CSHARP-4839
• Disallow comma character in authMechanismProperties connection string value - CSHARP-5106
• Fix translation issue during serialization of numbers with differing sizes - CSHARP-5163
• Support Linux distros using libdl.so.2 CSHARP-4889
• 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.26.0 Release Notes

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

The main new features in 2.26.0 include:

• Support SelectMany inside Project/Select - CSHARP-5081
• Support Dictionary.ContainsValue in LINQ queries - CSHARP-2509
• Support string concatenation of mixed types - CSHARP-5071
• Enable use of native crypto in libmongocrypt bindings - CSHARP-4944
• Support serialization of Memory and ReadOnlyMemory structs - CSHARP-4807
• OIDC: support for GCP Identity Provider - CSHARP-4610
• Implement signing of NuGet packages - CSHARP-5050
• Direct read/write retries to another mongos if possible - CSHARP-3757
• 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.25.0 Release Notes

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

.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.

.NET Driver Version 2.23.2 Release Notes

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.