DOCSP-46065: GUID serialization breaking change note #439
Conversation
✅ Deploy Preview for docs-csharp ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
source/upgrade/v3.txt
Outdated
|
|
||
| - The driver requires applications to explicitly configure how to serialize GUIDs | ||
| by using the ``GuidSerializationProvider`` and ``ObjectSerializer`` classes. To learn | ||
| more about GUID serialization, see :ref:`<csharp-guids>`. |
There was a problem hiding this comment.
| more about GUID serialization, see :ref:`<csharp-guids>`. | |
| more about GUID serialization, see the :ref:`csharp-guids` guide. |
source/upgrade/v3.txt
Outdated
| interfaces directly. | ||
|
|
||
| - The driver requires applications to explicitly configure how to serialize GUIDs | ||
| by using the ``GuidSerializationProvider`` and ``ObjectSerializer`` classes. To learn |
There was a problem hiding this comment.
I think GuidSerializationProvider is a typo, there is no such class.
You probably meant GuidSerializer.
It might also be worth mentioning that you need to "register" your configured GuidSerializer if you want it to apply globally everywhere in your application. Guid serialization can also be configured on a case by case basis without registering a GuidSerializer.
Registering a global GuidSerializer is only safe for NEW applications. For old applications it might be safe but the application writer is then responsible for verifying that all Guids in their application have in fact been serialized the same way in the past.
(cherry picked from commit fed7023)
(cherry picked from commit fed7023)
3 participants
Pull Request Info
PR Reviewing Guidelines
JIRA - https://jira.mongodb.org/browse/DOCSP-46065
Staging Links
https://deploy-preview-439--docs-csharp.netlify.app/upgrade/v3/
Self-Review Checklist