-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Release notes for 2.19.0. #1013
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 5 commits
Commits
Show all changes
7 commits
Select commit
Hold shift + click to select a range
dc4abf4
Release notes for 2.19.0.
BorisDog 357c442
- Docs link update
BorisDog e9cd0f1
- Docs link update
BorisDog dcb25cd
- Breaking changes info
BorisDog c31b015
- Styling
BorisDog 360bb91
- PR feedback
BorisDog a680127
- Links update
BorisDog File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,56 @@ | ||
# .NET Driver Version 2.19.0 Release Notes | ||
|
||
This is the general availability release for the 2.19.0 version of the driver. | ||
|
||
The main new features in 2.19.0 include: | ||
|
||
* Atlas Search builders | ||
* Default LinqProvider changed to LINQ3 | ||
* Support for Range Indexes preview | ||
* ObjectSerializer allowed types configuration | ||
* Bucket and BucketAuto stages support in LINQ3 | ||
* Support Azure VM-assigned Managed Identity for Automatic KMS Credentials | ||
* Native support for AWS IAM Roles | ||
|
||
### ObjectSerializer allowed types configuration | ||
|
||
The `ObjectSerializer` has been changed to only allow deserialization of types that are considered safe. | ||
What types are considered safe is determined by a new configurable `AllowedTypes` function (of type `Func<Type, bool>`). | ||
The default `AllowedTypes` function is `ObjectSerializer.DefaultAllowedTypes` which returns true for a number of well-known framework types that we have deemed safe. | ||
A typical example might be to allow all the default allowed types as well as your own types. This could be accomplished as follows: | ||
|
||
``` | ||
var objectSerializer = new ObjectSerializer(type => ObjectSerializer.DefaultAllowedTypes(type) || type.FullName.StartsWith("MyNamespace")); | ||
BsonSerializer.RegisterSerializer(objectSerializer); | ||
``` | ||
|
||
More information about the ObjectSerializer is available at FAQ page at: | ||
|
||
https://www.mongodb.com/docs/drivers/csharp/v2.19/ | ||
|
||
|
||
### Default LinqProvider changed to LINQ3 | ||
Default LinqProvider has been changed to LINQ3. | ||
LinqProvider can be changed back to LINQ2 in the following way: | ||
|
||
``` | ||
var connectionString = "mongodb://localhost"; | ||
var clientSettings = MongoClientSettings.FromConnectionString(connectionString); | ||
clientSettings.LinqProvider = LinqProvider.V2; | ||
var client = new MongoClient(clientSettings); | ||
``` | ||
If you encounter a bug in LINQ3 provider, please report it at: | ||
|
||
https://jira.mongodb.org/projects/CSHARP/issues | ||
|
||
An online version of these release notes is available at: | ||
|
||
https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.19.0.md | ||
|
||
The full list of JIRA issues resolved in this release is available at: | ||
|
||
https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.19.0%20ORDER%20BY%20key%20ASC | ||
|
||
Documentation on the .NET driver can be found at: | ||
|
||
https://www.mongodb.com/docs/drivers/csharp/v2.19/ |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ObjectSerializer =>
ObjectSerializer
(e.g. backticks around the class name)
is available in our FAQ.
The FAQ link should be correct based on the docs staging site.