Repository navigation
Breaking change note: stored NULL JSON collections materialize as null for nullable collection properties - #5526
Draft
ajcvickers wants to merge 1 commit into
Conversation
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The new EF Core 12.0 breaking-changes page is missing from entity-framework/toc.yml, so readers cannot discover it through the documentation navigation.
1 open issue
What changed in this PR
Adds an EF Core 12 breaking-change note documenting how nullable owned JSON collections now preserve the distinction between stored NULL and empty collections, including materialization, change tracking, opt-out, and compiled-model guidance.
Changes:
- Documents old and new materialization and tracking behavior.
- Explains mitigation with nullable annotations or SetIsNullable(false).
- Includes related issue links and compiled-model regeneration guidance.
| File | Description |
|---|---|
| entity-framework/core/what-is-new/ef-core-12.0/breaking-changes.md | Adds the EF Core 12 breaking-change documentation for nullable owned JSON collection properties. |
Review effort: Lite
| @@ -0,0 +1,71 @@ | |||
| --- | |||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

Adds a breaking change note to the EF Core 12 breaking changes page for dotnet/efcore#39630 (fixes dotnet/efcore#33452).
For owned JSON collections whose CLR property is annotated nullable, a stored
NULLis now materialized asnulleven when the property has an initializer, and changes betweennulland empty are tracked and saved. The note describes the opt-out (SetIsNullable(false)or removing the annotation).Draft until dotnet/efcore#39630 merges. Like the other open breaking change PRs, this adds
ef-core-12.0/breaking-changes.md, so whichever merges second needs a trivial merge of the page.🤖 Generated with Claude Code