.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 in createIndexes
• 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 and ClientDisconnect
• 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 in ListDatabases
• Session support for AsQueryable

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.0-beta2.md

The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC

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:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.4.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.4%20ORDER%20BY%20key%20ASC

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 and ClientDisconnect
• A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.0-beta1.md

The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC

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:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.3.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.3%20ORDER%20BY%20key%20ASC

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:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.2.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.2%20ORDER%20BY%20key%20ASC

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:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.1.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.1%20ORDER%20BY%20key%20ASC

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:

1. A number of minor bug fixes
2. New ReplaceOptions parameter for the ReplaceOne CRUD methods
3. Client-side field level encryption (FLE)

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.0.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.0%20ORDER%20BY%20key%20ASC

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:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.9.3.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.9.3%20ORDER%20BY%20key%20ASC

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:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.0-beta1.md

The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.0%20ORDER%20BY%20key%20ASC

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:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.9.2.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.9.2%20ORDER%20BY%20key%20ASC

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.