Skip to content

Commit 120749d

Browse files
committed
CSHARP-3887: Documentation on how to configure a client to use the new LINQ provider.
1 parent 7fe09a9 commit 120749d

File tree

5 files changed

+56
-2
lines changed

5 files changed

+56
-2
lines changed

Docs/reference/content/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ type = "index"
99

1010
The [Getting Started]({{< relref "getting_started\index.md" >}}) guide contains information about system requirements, installation, and a simple tutorial to get up and running quickly.
1111

12-
## What's new in 2.13.0
12+
## What's new in 2.14.0
1313

1414
The [What's New]({{< relref "what_is_new.md" >}}) section contains the major new features of the driver.
1515

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
+++
2+
date = "2021-10-11T00:00:00Z"
3+
draft = false
4+
title = "LINQ3"
5+
[menu.main]
6+
parent = "Reference Reading and Writing"
7+
identifier = "LINQ3"
8+
weight = 16
9+
pre = "<i class='fa'></i>"
10+
+++
11+
12+
## LINQ3
13+
14+
We are in the process of rewriting our LINQ provider. The new LINQ provider is known as LINQ3. The current LINQ provider is known as LINQ2 (and LINQ1 is the now obsolete LINQ provider in the v1.x releases of the driver).
15+
16+
While we fully transition to the new LINQ provider the two LINQ providers will exist side by side, and LINQ2 will continue to be the default LINQ provider for the time being.
17+
18+
In version 2.14.0 of the driver we are making the new LINQ provider available in beta form. In order to use it you have to configure your client to use the new LINQ provider, as follows:
19+
20+
```csharp
21+
var connectionString = "mongodb://localhost";
22+
var clientSettings = MongoClientSettings.FromConnectionString(connectionString);
23+
clientSettings.LinqProvider = LinqProvider.V3;
24+
var client = new MongoClient(clientSettings);
25+
```
26+
27+
The LINQ provider is only configurable at the client level. All LINQ queries run with a particular client use the same LINQ provider.

Docs/reference/content/what_is_new.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,14 @@ title = "What's New"
77
identifier = "What's New"
88
pre = "<i class='fa fa-star'></i>"
99
+++
10+
11+
## What's New in 2.14.0
12+
13+
The main new features in 2.1.40 include:
14+
15+
* A beta version of the new LINQ provider (known as LINQ3, see: [LINQ3]({{< relref "reference\driver\crud\linq3.md" >}}))
16+
* The current LINQ provider (known as LINQ2) continues to be available and is still the default LINQ provider for now
17+
1018
## What's New in 2.13.0
1119

1220
The main new features in 2.13.0 include:

GitVersion.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
next-version: 2.13.0
1+
next-version: 2.14.0
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# .NET Driver Version 2.14.0 Release Notes
2+
3+
This is a place holder file for the 2.14.0 Release Notes.
4+
5+
An online version of these release notes is available at:
6+
7+
https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.14.0.md
8+
9+
The list of JIRA tickets resolved in this release is available at:
10+
11+
https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.14.0%20ORDER%20BY%20key%20ASC
12+
13+
Documentation on the .NET driver can be found at:
14+
15+
http://mongodb.github.io/mongo-csharp-driver/
16+
17+
## Upgrading
18+
19+
There are no known backwards breaking changes in this release.

0 commit comments

Comments
 (0)