Releases: mongodb/mongo-csharp-driver
.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.Legacypackage - CSHARP-4917: Removing
MongoDB.Driver.Corepackage and various non-user-facing APIs (see v2.30.0 for deprecation messages) - CSHARP-5232: Embedding MongoDB.Driver.GridFS package into
MongoDB.Driverpackage - CSHARP-4912: Refactoring the Client Side field level description to an optional
MongoDB.Driver.Encryptionpackage.MongoDB.Libmongocryptpackage is not in use anymore and will not get any further updates - CSHARP-4911: Refactoring the AWS authentication to an optional
MongoDB.Driver.Authentication.AWSpackage - 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.
.NET Driver Version 2.23.1 Release Notes
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.