.NET 8 marcando JsonSerializerOptions como readonly

A partir do .NET 8, você pode marcar instâncias de JsonSerializerOptions como somente leitura, impedindo alterações posteriores na instância. Para congelar a instância, basta chamar MakeReadOnly na instância de options.

Vamos a um exemplo:

var options = new JsonSerializerOptions
{
    AllowTrailingCommas = true,
    PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseUpper,
    PreferredObjectCreationHandling = JsonObjectCreationHandling.Populate,
};

options.MakeReadOnly();

Você também pode verificar se uma instância já foi congelada consultando a propriedade IsReadOnly.

options.IsReadOnly

Tentar modificar uma instância de JsonSerializerOptions depois de marcá-la como somente leitura resulta em uma InvalidOperationException:

Unhandled exception. System.InvalidOperationException: This JsonSerializerOptions instance is read-only or has already been used in serialization or deserialization.
   at System.Text.Json.ThrowHelper.ThrowInvalidOperationException_SerializerOptionsReadOnly(JsonSerializerContext context)
   at System.Text.Json.JsonSerializerOptions.VerifyMutable()

Sobrecarga MakeReadOnly(bool populateMissingResolver)

Quando populateMissingResolver é passado como true, o método adiciona o resolver padrão baseado em reflexão ao seu JsonSerializerOptions caso esteja faltando. Cuidado ao usar esse método em aplicações trimmed / Native AOT, pois ele vai puxar os assemblies relacionados a reflexão e incluí-los na sua build.