ASP.NET Core MVC input and output formatters backed by Nerdbank.Json, enabling AOT-safe, source-generated JSON in MVC and minimal-hosting Web APIs with an explicitly supplied ITypeShapeProvider.
Get Started
| Product | Versions |
|---|---|
| .NET |
README
Nerdbank.Json.AspNetCoreMvcFormatter
ASP.NET Core MVC input and output formatters backed by Nerdbank.Json, enabling source-generated JSON in controller-based Web APIs, including apps using the minimal hosting model. This package supplies MVC formatters, not Minimal API JSON integration.
Unlike the built-in System.Text.Json formatters, these formatters:
- use an explicitly supplied, source-generated
ITypeShapeProvider— no reflection and no runtime type discovery; - stream request and response bodies incrementally through Nerdbank.Json's
PipeReader/PipeWriterAPIs; - are trimming- and NativeAOT-safe.
Usage
Call AddNerdbankJsonFormatters(serializer, shapeProvider, configure) on the builder returned by AddControllers or AddMvcCore.
The extension methods are in Microsoft.Extensions.DependencyInjection.
Supply a source-generated ITypeShapeProvider that describes every type the formatters can read or write.
See the compilable MVC sample and the formatter guide.
For direct registration, JsonInputFormatter and JsonOutputFormatter are in the Nerdbank.Json.AspNetCoreMvcFormatter namespace.
Their constructors accept the provider first and the serializer second.
Provider-only constructors use a default serializer.
By default the Nerdbank.Json formatters are inserted before the built-in System.Text.Json formatters (so they win
content negotiation for application/json and +json media types) but do not remove them.
Set ReplaceSystemTextJsonFormatters in the registration callback to remove the built-in JSON formatters.
Set InsertFirst to false to append rather than prepend the Nerdbank.Json formatters.
Both options are properties of NerdbankJsonFormatterOptions.
During content negotiation, the formatters decline model types the provider cannot describe, allowing other registered formatters to handle types such as ProblemDetails.
If a formatter is invoked directly for an unsupported type, it throws MissingTypeShapeException rather than silently binding null or using reflection.
When replacing the built-in JSON formatters, include all response and error types in the provider.
Downloads by Version
Similar & Alternative Packages
Hand-picked matching NuGet libraries based on tags & ecosystem
Depended On By
Find packages that declare this package as a dependency. NuGet does not provide a reverse-dependency endpoint, so candidates are checked on demand.
Adoption Assessment
A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.
Related Guides & Workflows
Learn how to evaluate, integrate, or audit this package in your .NET project.