Skip to content

DOCSP-44801: Client-side projection breaking v3.0 breaking change #321

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.

Sign up for GitHub

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 5 commits into from
Nov 26, 2024
Merged

DOCSP-44801: Client-side projection breaking v3.0 breaking change #321

Changes from 4 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
16733eb
DOCSP-44801: Client-side projection breaking v3.0 breaking change
mcmorisi Nov 20, 2024
7d02b8e
Fix
mcmorisi Nov 20, 2024
6cc21eb
Fix
mcmorisi Nov 20, 2024
057ef51
Fix
mcmorisi Nov 20, 2024
a1112b0
NR feedback
mcmorisi Nov 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion source/upgrade/v3.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,16 @@ Version 3.0 Breaking Changes
To configure logging in your application, see the :ref:`csharp-logging` guide.

- The LINQ2 provider has been removed from this version of the driver.
You must use LINQ3 for all LINQ queries.
You must use LINQ3 for all LINQ queries. This change has the following effect on the
Copy link
Collaborator

@norareidy norareidy Nov 20, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: since there's only one item in this nested list, it might make more sense to just combine it all into one paragraph? Or add a line break after "You must use LINQ3 for all LINQ queries" and start a new paragraph with "Queries that use client-side projections..."

driver:

- Queries that use client-side projections will throw an ``ExpressionNotSupportedException``
by default with v3.0. To enable client-side projections, set the
Copy link
Collaborator

@norareidy norareidy Nov 20, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S: add "error"; also since this is in the v3.0 section, I don't think you need to specify that again

Suggested change
- Queries that use client-side projections will throw an ``ExpressionNotSupportedException``
by default with v3.0. To enable client-side projections, set the
- Queries that use client-side projections will throw an ``ExpressionNotSupportedException`` error
by default. To enable client-side projections, set the

``EnableClientSideProjections`` property of a ``TranslationOptions`` object to
``true``. You can pass this ``TranslationOptions`` object to an
``AggregateOptions`` or ``FindOptions`` object to enable client-side projections
for a single query, or to a ``MongoClientSettings`` object to enable client-side projections
for all queries in an application.

- Previous versions of the {+driver-short+} supported two GUID representation modes.
In version 3.0, ``GuidRepresentationMode.V3`` is the only supported mode. This change
Expand Down
Loading