From 16733ebd84a42e3b2bd784501624e95b512672e6 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 20 Nov 2024 15:19:48 -0500 Subject: [PATCH 1/5] DOCSP-44801: Client-side projection breaking v3.0 breaking change --- source/upgrade/v3.txt | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/source/upgrade/v3.txt b/source/upgrade/v3.txt index 6fd7efd6..5515b96b 100644 --- a/source/upgrade/v3.txt +++ b/source/upgrade/v3.txt @@ -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 effects on the + driver: + + - Queries that use client-side projections will throw an ``ExpressionNotSupportedException`` + by default with v3.0. To enable client-side projections, set the + ``EnableClientSideProjections`` property of a ``TranslationOptions`` object to + ``true``. You can pass this ``TranslationOptions`` object to the + ``AggregateOptions`` or ``FindOptions`` objects 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 From 7d02b8e8fdc0bf56f5ba8a58274dbf7a54e71e6d Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 20 Nov 2024 15:23:36 -0500 Subject: [PATCH 2/5] Fix --- source/upgrade/v3.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/upgrade/v3.txt b/source/upgrade/v3.txt index 5515b96b..0ed35196 100644 --- a/source/upgrade/v3.txt +++ b/source/upgrade/v3.txt @@ -103,8 +103,8 @@ Version 3.0 Breaking Changes - Queries that use client-side projections will throw an ``ExpressionNotSupportedException`` by default with v3.0. To enable client-side projections, set the ``EnableClientSideProjections`` property of a ``TranslationOptions`` object to - ``true``. You can pass this ``TranslationOptions`` object to the - ``AggregateOptions`` or ``FindOptions`` objects to enable client-side projections + ``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. From 6cc21eb14057ec3c2ba2cab0033608765b414cb5 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 20 Nov 2024 15:27:50 -0500 Subject: [PATCH 3/5] Fix --- source/upgrade/v3.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/upgrade/v3.txt b/source/upgrade/v3.txt index 0ed35196..f0da8bb0 100644 --- a/source/upgrade/v3.txt +++ b/source/upgrade/v3.txt @@ -110,7 +110,7 @@ Version 3.0 Breaking Changes - Previous versions of the {+driver-short+} supported two GUID representation modes. In version 3.0, ``GuidRepresentationMode.V3`` is the only supported mode. This change - has the following effects on the driver: + has the following effect on the driver: - The ``BsonBinaryData(Guid)`` constructor has been removed. To construct a ``BsonBinaryData`` object from a GUID, use the ``BsonBinaryData.Create(Guid, GuidRepresentation)`` constructor. From 057ef51dc8ed1421151ef29b8a01139bf20d0099 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 20 Nov 2024 15:32:20 -0500 Subject: [PATCH 4/5] Fix --- source/upgrade/v3.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/upgrade/v3.txt b/source/upgrade/v3.txt index f0da8bb0..449815b1 100644 --- a/source/upgrade/v3.txt +++ b/source/upgrade/v3.txt @@ -97,7 +97,7 @@ 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. This change has the following effects on the + You must use LINQ3 for all LINQ queries. This change has the following effect on the driver: - Queries that use client-side projections will throw an ``ExpressionNotSupportedException`` @@ -110,7 +110,7 @@ Version 3.0 Breaking Changes - Previous versions of the {+driver-short+} supported two GUID representation modes. In version 3.0, ``GuidRepresentationMode.V3`` is the only supported mode. This change - has the following effect on the driver: + has the following effects on the driver: - The ``BsonBinaryData(Guid)`` constructor has been removed. To construct a ``BsonBinaryData`` object from a GUID, use the ``BsonBinaryData.Create(Guid, GuidRepresentation)`` constructor. From a1112b0f7aedbdbbbd00de86c989613a5a3348bd Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 20 Nov 2024 15:44:43 -0500 Subject: [PATCH 5/5] NR feedback --- source/upgrade/v3.txt | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/source/upgrade/v3.txt b/source/upgrade/v3.txt index 449815b1..0cd51180 100644 --- a/source/upgrade/v3.txt +++ b/source/upgrade/v3.txt @@ -97,16 +97,15 @@ 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. This change has the following effect on the - driver: - - - Queries that use client-side projections will throw an ``ExpressionNotSupportedException`` - by default with v3.0. 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. + You must use LINQ3 for all LINQ queries. + + 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