Skip to content

Commit fed7023

Browse files
authored
DOCSP-46065: GUID serialization breaking change note (#439)
1 parent 17ddb07 commit fed7023

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

source/upgrade/v3.txt

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -248,3 +248,13 @@ Version 3.0 Breaking Changes
248248
- The driver seals the ``MongoClient``, ``MongoDatabase``, and ``MongoCollection`` classes.
249249
We recommend using the ``IMongoClient``, ``IMongoDatabase``, and ``IMongoCollection``
250250
interfaces directly.
251+
252+
- The driver requires applications to explicitly configure how to serialize GUIDs
253+
by using the ``GuidSerializer`` and ``ObjectSerializer`` classes. {+driver-short+}
254+
users building new applications can implement a global ``GuidSerializer`` by registering
255+
it. We recommend that users with older applications verify that all ``GUIDs`` are
256+
serialized the same way when implementing a global ``GuidSerializer``. You can also
257+
configure ``GUID`` serialization on a case-by-case basis without registering a global
258+
``GuidSerializer``.
259+
260+
To learn more about GUID serialization, see the :ref:`csharp-guids` guide.

0 commit comments

Comments
 (0)