Releases: mongodb/mongo-csharp-driver
.NET Driver Version 2.11.0 Release Notes
.NET Driver Version 2.11.0 Release Notes
The main new features in 2.11.0 support new features in MongoDB 4.4.0. These features include:
- Support for all new
$meta
projections:randVal
,searchScore
,searchHighlights
,
geoNearDistance
,geoNearPoint
,recordId
,indexKey
and
sortKey
- Support for passing a hint to update commands as well as
findAndModify
update and replace operations - Support for
allowDiskUse
on find operations - Support for
MONGODB-AWS
authentication using Amazon Web Services
(AWS) Identity and Access Management (IAM) credentials - Support for stapled OCSP (Online Certificate Status Protocol) (macOS only)
- Support for shorter SCRAM (Salted Challenge Response Authentication Mechanism) conversations
- Support for speculative SCRAM and MONGODB-X509 authentication
- Support for the
CommitQuorum
option increateIndexes
- Support for hedged reads
Other new additions and updates in this release include:
- A new target of .NET Standard 2.0
- Support for Snappy compression on .NET Core on Windows (in addition
to existing support on .NET Framework) - Support for Zstandard compression on Windows on 64-bit platforms
- A new URI option
tlsDisableCertificateRevocationCheck
to disable
certificate revocation checking. - An expanded list of retryable write errors via the inclusion of
ExceededTimeLimit
,LockTimeout
andClientDisconnect
- A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode
- Improved SDAM (Server Discovery and Monitoring) error handling
- Support for the
AuthorizedDatabases
option inListDatabases
- Session support for
AsQueryable
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:
.NET Driver Version 2.11.0-beta2 Release Notes
.NET Driver Version 2.11.0-beta2 Release Notes
This is a beta release for the 2.11.0 version of the driver.
The main new features in 2.11.0-beta2 support new features in MongoDB 4.4.0. These features include:
- Support for all new
$meta
projections:randVal
,searchScore
,searchHighlights
,
geoNearDistance
,geoNearPoint
,recordId
,indexKey
and
sortKey
- Support for passing a hint to update commands as well as
findAndModify
update and replace operations - Support for
allowDiskUse
on find operations - Support for
MONGODB-AWS
authentication using Amazon Web Services
(AWS) Identity and Access Management (IAM) credentials - Support for stapled OCSP (Online Certificate Status Protocol) (macOS only)
- Support for shorter SCRAM (Salted Challenge Response Authentication Mechanism) conversations
- Support for speculative SCRAM and MONGODB-X509 authentication
- Support for the
CommitQuorum
option increateIndexes
- Support for hedged reads
Other new additions and updates in this beta include:
- A new target of .NET Standard 2.0
- Support for Snappy compression on .NET Core on Windows (in addition
to existing support on .NET Framework) - Support for Zstandard compression on Windows on 64-bit platforms
- A new default of enabling certificate revocation checking.
- A new URI option
tlsDisableCertificateRevocationCheck
to disable
certificate revocation checking. - An expanded list of retryable write errors via the inclusion of
ExceededTimeLimit
,LockTimeout
andClientDisconnect
- A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode
- Improved SDAM (Server Discovery and Monitoring) error handling
- Support for the
AuthorizedDatabases
option inListDatabases
- Session support for
AsQueryable
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
Backwards compatibility with driver version 2.7.0–2.10.x
Because certificate revocation checking is now enabled by default, an
application that is unable to contact the OCSP endpoints and/or CRL
distribution points specified in a server's certificate may experience
connectivity issues (e.g. if the application is behind a firewall with
an outbound whitelist). This is because the driver needs to contact
the OCSP endpoints and/or CRL distribution points specified in the
server’s certificate and if these OCSP endpoints and/or CRL
distribution points are not accessible, then the connection to the
server may fail. In such a scenario, connectivity may be able to be
restored by disabling certificate revocation checking by adding
tlsDisableCertificateRevocationCheck=true
to the application's connection
string.
.NET Driver Version 2.10.4 Release Notes
.NET Driver Version 2.10.4 Release Notes
This is a patch release that fixes a couple of bugs reported since 2.10.3 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.11.0-beta1 Release Notes
.NET Driver Version 2.11.0-beta1 Release Notes
This is a beta release for the 2.11.0 version of the driver.
The main new features in 2.11.0-beta1 support new features in MongoDB 4.4.0. These features include:
- Support for all new
$meta
projections:randVal
,searchScore
,searchHighlights
,
geoNearDistance
,geoNearPoint
,recordId
,indexKey
and
sortKey
- Support for passing a hint to update commands as well as
findAndModify
update and replace operations - Support for
allowDiskUse
on find operations - Support for
MONGODB-AWS
authentication using Amazon Web Services
(AWS) Identity and Access Management (IAM) credentials - Support for stapled OCSP (Online Certificate Status Protocol) (macOS only)
Other new additions and updates in this beta include:
- A new target of .NET Standard 2.0
- Support for Snappy compression on .NET Core on Windows (in addition
to existing support on .NET Framework) - Support for Zstandard compression on Windows on 64-bit platforms
- A new default of enabling certificate revocation checking.
- A new URI option
tlsDisableCertificateRevocationCheck
to disable
certificate revocation checking. - An expanded list of retryable write errors via the inclusion of
ExceededTimeLimit
,LockTimeout
andClientDisconnect
- A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode
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
Backwards compatibility with driver version 2.7.0–2.10.x
Because certificate revocation checking is now enabled by default, an
application that is unable to contact the OCSP endpoints and/or CRL
distribution points specified in a server's certificate may experience
connectivity issues (e.g. if the application is behind a firewall with
an outbound whitelist). This is because the driver needs to contact
the OCSP endpoints and/or CRL distribution points specified in the
server’s certificate and if these OCSP endpoints and/or CRL
distribution points are not accessible, then the connection to the
server may fail. In such a scenario, connectivity may be able to be
restored by disabling certificate revocation checking by adding
tlsDisableCertificateRevocationCheck=true
to the application's connection
string.
.NET Driver Version 2.10.3 Release Notes
.NET Driver Version 2.10.3 Release Notes
This is a patch release that fixes several bugs reported since 2.10.2 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.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.