Add MaxDepth to JsonWriterOptions

[amosonn]

Background and Motivation

Whereas JsonReaderOptions has MaxDepth property, JsonWriterOptions does not, instead taking a constant. While this constant is quite large (1000, compared to the default 64 on reading), there is no easy way to work with larger depths.

Even worse, JsonSerializerOptions has a MaxDepth property, but is not respected on Serialize, as there is no way to pass it on to the JsonWriter.

Proposed API

Add a JsonWriterOptions.MaxDepth property; set that property when called from JsonSerializer.

namespace System.Text.Json
{
    public partial struct JsonWriterOptions
    {
        public bool MaxDepth { get; set; }
    }
}

Alternative Designs

The current API, where this is a constant. This decision is described in #27938 , but I couldn't see a rationale.

[eiriktsarpalis]

I've updated the API proposal and marked it ready for review.

[terrajobst]

Video

• Looks good as proposed

namespace System.Text.Json
{
    public partial struct JsonWriterOptions
    {
        public int MaxDepth { get; set; }
    }
}