Releases: mongodb/mongo-csharp-driver
v2.7.0
.NET Driver Version 2.7.0 Release Notes
The main new features of 2.7.0 are support for new features of the 4.0.0 version of the server including:
- Transactions
- New CountDocuments and EstimatedDocumentCount methods (depending on whether you need an exact result or a fast estimate)
- Support for change streams on all collections in a cluster or a particular database via the new Watch methods on IMongoClient and IMongoDatabase
- SCRAM-SHA-256 authentication
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
-
The .NET Driver now disables certificate revocation checking by default, setting
CheckCertificateRevocationinSslSettingstofalseby default. Any applications relying on the older default oftruenow must explicitly setCheckCertificateRevocationtotrueinSslSettingsto re-enable certificate revocation checking.Previously, the driver enabled certificate revocation checking by default, in contrast to the
mongoshell and other MongoDB drivers. This was also in contrast to .NET's defaults forSslStream(see .NET Framework documentation here and .NET Standard documentation here).
Known Issues:
- Incomplete SCRAM-SHA-256 Support in .NET Standard: In .NET Standard, authenticating via SCRAM-SHA-256 may not work with non-ASCII passwords because SaslPrep is not fully implemented due to the lack of a string normalization function in .NET Standard 1.5. Normalizing the password into Unicode Normalization Form KC beforehand MAY help. SCRAM-SHA-1 is the recommended alternative (when targeting .NET Standard) for now.
v2.6.1
.NET Driver Version 2.6.1 Release Notes
This is a patch release that fixes a few bugs reported since 2.6.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.
v2.6.0
.NET Driver Version 2.6.0 Release Notes
The main new feature of 2.6.0 is better support for running when FIPS mode is enabled in the operating system.
- GridFS now has an option to disable MD5 checksum computation
- PasswordEvidence has been refactored to no longer use MD5
An online version of these release notes is available at:
The JIRA tickets resolved in this release is available at:
Upgrading
We believe there are only minor breaking changes in classes that normally would not be directly used by applications.
v2.7.0-beta1
.NET Driver Version 2.7.0-beta1 Release Notes
This is a beta release of the 2.7.0 version of the driver that will be released with MongoDB server version 4.0.
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.5.1
.NET Driver Version 2.5.1 Release Notes
This is a patch release that fixes a few bugs reported since 2.5.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.
v2.5.0
.NET Driver Version 2.5.0 Release Notes
The main new feature of 2.5.0 is support for the new features of the 3.6 version of the server:
- Sessions
- Causal consistency
- Retryable writes
- Change streams via the collection Watch method to observe changes to a collection
- Array filters for update operations
- Translating DateTime expressions in LINQ to $dateFromParts and $dateFromString operators
- The new "mongodb+srv://" connection string scheme
- Improved support for reading and writing UUIDs in BsonBinary subtype 4 format
An online version of these release notes is available at:
The JIRA tickets resolved in this release is available at:
Upgrading
We believe there are only minor breaking changes in classes that normally would not be directly used by applications.
v2.4.4
.NET Driver Version 2.4.4 Release Notes
This is a patch release that fixes a few bugs reported since 2.4.3 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.
v2.4.3
.NET Driver Version 2.4.3 Release Notes
This is a patch release that fixes a few bugs reported since 2.4.2 was released.
Most of the changes are minor, but if you use X509 certificates with SSL you should
definitely upgrade to 2.4.3. See:
https://jira.mongodb.org/browse/CSHARP-1914
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.
v2.4.2
.NET Driver Version 2.4.2 Release Notes
This is a patch release that fixes a few bugs reported since 2.4.1 was released.
The main change is adding back support for using a which is not the same as the actual
field type in filter builder methods and the Distinct method. Normally is expected to
match the actual field type, but it turns out there are cases where one might want to specify
a type for that does not match the field type exactly. See the following tickets for
more information about these changes
https://jira.mongodb.org/browse/CSHARP-1884
https://jira.mongodb.org/browse/CSHARP-1890
https://jira.mongodb.org/browse/CSHARP-1891
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.
v2.4.1
.NET Driver Version 2.4.1 Release Notes
This is a patch release which fixes a few bugs reported since 2.4.0 was released.
It is a required upgrade if you are using MongoDB-X509 authentication. See:
https://jira.mongodb.org/browse/CSHARP-1861
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.