I have recently upgraded my web api from .Net core 2.2 to .Net core 3.0 and noticed that my requests are getting an error now when I pass an enum in a post to my endpoint.
For those who is looking for a snippet
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers().AddJsonOptions(opt =>
{
opt.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
});
}
As of version 3.0, .NET Core no longer uses the third-party Newtonsoft.Json
(Json.NET) by default but the new, built-in System.Text.Json
(STJ) serializer - which is not as feature-rich as Json.NET, and of course has its own issues and learning curve to get the expected features.
If you’d like to switch back to the previous default of using Newtonsoft.Json
, then you'll have to do the following:
Install the Microsoft.AspNetCore.Mvc.NewtonsoftJson NuGet package.
In ConfigureServices()
add a call to AddNewtonsoftJson()
public void ConfigureServices(IServiceCollection services) {
//...
services.AddControllers()
.AddNewtonsoftJson(); //<--
//...
}
Support for serializing enums as strings already exist if you use the built-in JsonStringEnumConverter and pass that into the JsonSerializerOptions: https://docs.microsoft.com/en-us/dotnet/api/system.text.json.serialization.jsonstringenumconverter?view=netcore-3.0
Here's a sample test that uses it: https://github.com/dotnet/corefx/blob/master/src/System.Text.Json/tests/Serialization/ReadScenarioTests.cs#L17