Skip to content

Document JsonSerializerDefaults.Strict behavior #12255

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
eiriktsarpalis merged 3 commits into from
Jan 22, 2026
Merged

Document JsonSerializerDefaults.Strict behavior #12255

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
9fc3a09
Initial plan
Copilot Jan 22, 2026
4f7bf31
Update JsonSerializerDefaults.Strict documentation with detailed beha…
Copilot Jan 22, 2026
95e45a9
Refactor remarks sections for JSON serializer options
gewarren Jan 22, 2026
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
41 changes: 19 additions & 22 deletions xml/System.Text.Json/JsonSerializerDefaults.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,15 +50,7 @@
<para>General-purpose option values. These are the same settings that are applied if a <see cref="T:System.Text.Json.JsonSerializerDefaults" /> member isn't specified.</para>
<para>For information about the default property values that are applied, see <see href="https://learn.microsoft.com/dotnet/api/system.text.json.jsonserializeroptions#properties">JsonSerializerOptions properties</see>.</para>
</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks

This option implies that property names are treated as case-sensitive and that "PascalCase" name formatting should be employed.

]]></format>
</remarks>
<remarks>This option implies that property names are treated as case-sensitive and that "PascalCase" name formatting should be employed.</remarks>
</Docs>
</Member>
<Member MemberName="Strict">
Expand All @@ -79,7 +71,17 @@ This option implies that property names are treated as case-sensitive and that "
</ReturnValue>
<MemberValue>2</MemberValue>
<Docs>
<summary>Specifies that stricter policies should be applied when deserializing from JSON.</summary>
<summary>
<para>Option values appropriate for strict JSON parsing.</para>
<para>This member implies that:</para>
<list type="bullet">
<item>Unmapped JSON properties aren't allowed.</item>
<item>Duplicate JSON properties aren't allowed.</item>
<item>Nullable reference type annotations are respected.</item>
<item>Required constructor parameters are respected.</item>
</list>
</summary>
<remarks>This option configures stricter deserialization behavior that rejects unmapped or duplicate properties, and enforces both nullable annotations and required constructor parameters.</remarks>
</Docs>
</Member>
<Member MemberName="Web">
Expand Down Expand Up @@ -108,19 +110,14 @@ This option implies that property names are treated as case-sensitive and that "
<summary>
<para>Option values appropriate to Web-based scenarios.</para>
<para>This member implies that:</para>
<para>- Property names are treated as case-insensitive.</para>
<para>- "camelCase" name formatting should be employed.</para>
<para>- Quoted numbers (JSON strings for number properties) are allowed.</para>
<list type="bullet">
<item>Integers must be encoded as small as possible.</item>
<item>Property names are treated as case-insensitive.</item>
<item>"camelCase" name formatting should be employed.</item>
<item>Quoted numbers (JSON strings for number properties) are allowed.</item>
</list>
</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks

This option implies that property names are treated as case-insensitive and that "camelCase" name formatting should be employed.

]]></format>
</remarks>
<remarks>This option implies that property names are treated as case-insensitive and that "camelCase" name formatting should be employed.</remarks>
</Docs>
</Member>
</Members>
Expand Down