Releases: mongodb/mongo-csharp-driver
.NET Driver Version 2.10.2 Release Notes
.NET Driver Version 2.10.2 Release Notes
IMPORTANT:
If you are using unacknowledged writes (also known as w:0 writes) with versions 2.10.0 or 2.10.1 of the driver, we strongly recommend you upgrade to version 2.10.2 as soon as possible, to obtain the fix for a critical issue: https://jira.mongodb.org/browse/CSHARP-2960.
This is a patch release that fixes several bugs reported since 2.10.1 was released.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
Installing
The binary packages are now released only on Nuget.
.NET Driver Version 2.10.1 Release Notes
.NET Driver Version 2.10.1 Release Notes
This is a patch release that fixes several bugs reported since 2.10.0 was released.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
.NET Driver Version 2.10.0 Release Notes
.NET Driver Version 2.10.0 Release Notes
The main changes in 2.10.0 are:
- A number of minor bug fixes
- New ReplaceOptions parameter for the ReplaceOne CRUD methods
- Client-side field level encryption (FLE)
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Documentation on the new client-side field level encryption feature can be found at:
http://mongodb.github.io/mongo-csharp-driver/2.10/reference/driver/crud/client_side_encryption/
Upgrading
There are no known backwards breaking changes in this release.
.NET Driver Version 2.9.3 Release Notes
.NET Driver Version 2.9.3 Release Notes
This is a patch release that fixes several bugs reported since 2.9.2 was released and improves support for ISupportInitialize.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.10.0-beta1
.NET Driver Version 2.10.0-beta1 Release Notes
This is a beta release for the 2.10.0 version of the driver.
The main new features in 2.10.0-beta1 are:
- Support for Client-Side Field Level Encryption (Windows-only)
An online version of these release notes is available at:
The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:
The list may change as we approach the release date.
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
Support for client side encryption is in beta. Backwards-breaking changes may be made before the final release.
v2.9.2
.NET Driver Version 2.9.2 Release Notes
This is a patch release that fixes several bugs reported since 2.9.1 was released.
Most notably in the .NET Framework version of the driver, snappy compression now works properly with servers ≥ 3.6.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.9.1
.NET Driver Version 2.9.1 Release Notes
This is a patch release that fixes one bug reported since 2.9.0 was released.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
A bug in 2.9.0 prevents applications from connecting to replica sets via SRV. Applications connecting to replica sets over SRV should NOT upgrade to 2.9.0 and instead should upgrade directly to 2.9.1 or later.
v2.9.0
.NET Driver Version 2.9.0 Release Notes
The main new features in 2.9.0 are:
- Distributed transactions on sharded clusters
- The sessions API supports the
IClientSession.WithTransaction()method to conveniently run a transaction with automatic retries and at-most-once semantics. - Support for message compression
- SRV polling for
mongodb+srvconnection scheme: DNS SRV records are periodically polled in order to update the mongos proxy list without having to change client configuration or even restart the client application. This feature is particularly useful when used with a sharded cluster on MongoDB Atlas, which dynamically updates SRV records whenever you resize your Atlas sharded cluster. - Retryable reads: The diver can automatically retry any read operation that has not yet received any results (due to a transient network error, a "not master" error after a replica set failover, etc.). This feature is enabled by default.
- Retryable writes are now enabled by default.
- Update specification using an aggregation framework pipeline
- SCRAM-SHA authentication caching
- Connections to the replica set primary are no longer closed after a step-down, allowing in progress read operations to complete.
- New aggregate helper methods support running database-level aggregations.
- Aggregate helper methods now support the
$mergepipeline stage, and builder methods support creation of the new pipeline stage. - Change stream helpers now support the
startAfteroption. - Index creation helpers now support wildcard indexes.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
Applications with custom retry logic should note that retryable reads and writes default to true. Any applications that rely on the driver's old behavior of not automatically retrying reads and writes should update their connection strings to turn off retryable reads/writes as needed. Otherwise, the new default may cause unexpected behavior.
For example, if an application has custom logic that retries reads n times, then after upgrading to 2.9.0, the application could end up retrying reads up to 2n times because the driver defaults to retrying reads.
v2.9.0-beta2
.NET Driver Version 2.9.0-beta2 Release Notes
This is a beta release for the 2.9.0 version of the driver that will be released with MongoDB server version 4.2.
The main features in 2.9.0-beta2 are:
- Sharded transactions using the same API as replica set transactions
- Convenient API for transactions
- Support for message compression
- SRV polling for mongodb+srv connection scheme
- Retryable reads on by default
- Retryable writes on by default
- Update specification using an aggregation framework pipeline
An online version of these release notes is available at:
The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:
The list may change as we approach the release date.
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.8.1
.NET Driver Version 2.8.1 Release Notes
This is a patch release that fixes a few bugs reported since 2.8.0 was released.
An online version of these release notes is available at:
The full list of JIRA issues resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.