nikit0s/AspNetCore.Docs
1
0
Fork 0
mirror of https://github.com/dotnet/AspNetCore.Docs.git synced 2026-06-20 01:57:41 +00:00
Code Issues Projects Releases Packages Wiki Activity
Documentation for ASP.NET Core https://docs.microsoft.com/aspnet/core
20,581 commits 71 branches 40 tags 1,022 MiB
  • C# 54.1%
  • HTML 24.6%
  • JavaScript 16.1%
  • Less 2.7%
  • CSS 1.6%
  • Other 0.9%
Find a file
Exact
Korolev Dmitry 0d0a7bdea6
 Document C# union types in ASP.NET Core (.NET 11) (#37261) 
* Add docs for C# union types in ASP.NET Core (.NET 11)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Replace dotnet GitHub issue links with published docs references

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Clarify union deserialization ambiguity under web defaults

Document that AllowReadingFromString in web defaults makes numeric+string unions ambiguous on the String token in Minimal APIs and MVC (400 without a classifier), while plain STJ and SignalR JsonHubProtocol deserialize them without a classifier.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address review feedback on unions article

- Link Request Delegate Generator to RDG docs
- Replace raw tested-scenario list with concise prose and a showcase snippet
- Scope MVC section to controllers only (drop Razor Pages)
- Show Cat/Dog component schemas in the OpenAPI example
- Invite parameter-binding feedback via aspnetcore#66648; drop redundant closing line

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Simplify classifier reader usage and trim repeated AllowReadingFromString mentions

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* address PR comments

* Move C# unions article out of minimal-apis and add Blazor coverage

The article covers unions across Minimal APIs, MVC, SignalR, Blazor, and
OpenAPI, so it doesn't belong under the Minimal APIs node. Move it to
fundamentals/unions (uid fundamentals/unions) and update the TOC and the
what's-new include xref. No redirect is needed because the article is new
in this unmerged PR and was never published.

Add a Blazor section documenting union support across component
parameters, JavaScript interop, persisted component state, and
prerendering, plus the non-body binding limitation for
[SupplyParameterFromQuery] and [SupplyParameterFromForm].

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update aspnetcore/fundamentals/unions.md

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* Update aspnetcore/fundamentals/unions.md

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* Update aspnetcore/fundamentals/unions.md

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

* Apply suggestions from code review

Co-authored-by: Wade Pickett <wpickett@microsoft.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Wade Pickett <wpickett@microsoft.com>
2026-06-19 12:49:29 -07:00
.github Add breaking change agent (#37258) 2026-06-16 19:08:21 +02:00
.vscode Blazor-DataBinding-FormsXrefFix (#31968) 2024-03-05 06:07:19 -05:00
aspnetcore Document C# union types in ASP.NET Core (.NET 11) (#37261) 2026-06-19 12:49:29 -07:00
.editorconfig Add initial .editorconfig and extra markdownlint rules (#25293) 2022-03-14 14:20:31 +00:00
.gitattributes Update .gitattributes (#10285) 2019-01-08 16:50:53 -10:00
.gitignore OpenAPI Controllers Sample with XML Comments (#36770) 2026-02-22 13:02:28 -08:00
.markdownlint.json Add initial .editorconfig and extra markdownlint rules (#25293) 2022-03-14 14:20:31 +00:00
.openpublishing.publish.config.json Change notification subscriber from riande to wpickett (#36280) 2025-11-03 09:31:33 -08:00
.openpublishing.redirection.json Resource-based authz article overhaul (#37097) 2026-05-20 06:27:40 -04:00
.repoman.yml Moving things from repoman to policy (#34424) 2025-01-08 08:59:09 -10:00
.whatsnew.json Remove What's New in Docs collection and add forward redirects (#35893) 2025-08-06 13:40:20 -07:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#15287) 2019-10-23 13:08:23 -10:00
CONTRIBUTING.md update links that result in 404 results (#35293) 2025-04-23 15:37:28 -04:00
cspell.json Passkeys coverage (#35943) 2025-09-08 13:44:22 -04:00
LICENSE Legal updates from CELA (#2977) 2017-03-15 11:31:01 -10:00
LICENSE-CODE Legal updates from CELA (#2977) 2017-03-15 11:31:01 -10:00
quest-config.json simplify config (#36146) 2025-09-23 13:05:06 -05:00
README.md Minor documentation improvement (#35930) 2025-08-12 16:21:27 -04:00
ThirdPartyNotices Remove Deadlinks in aspnetcore section of repo (#4241) 2017-09-11 20:58:51 -05:00

README.md

ASP.NET Core Docs

This repository contains the official ASP.NET Core documentation. See the Contributing Guide and the issues list if you would like to help.

The dotnet/AspNetDocs GitHub repositorycontains the ASP.NET 4.x documentation.

How to open an issue

If the issue is with an ASP.NET Core document:

  • Do not open a blank issue.
  • Open the issue using the Open a documentation issue link and feedback form at the bottom of the article.

Using the Open a documentation issue link and form to open an issue adds article metadata for tracking, which indicates the article that you're commenting on and automatically pings the author for a faster response.

If the issue is: