Class JsonParser.Settings (3.15.8)

public sealed class Settings : object

Settings controlling JSON parsing.

Inheritance

Object > JsonParser.Settings

Namespace

Google.Protobuf

Assembly

Google.Protobuf.dll

Constructors

Settings(Int32)

public Settings(int recursionLimit)

Creates a new JsonParser.Settings object with the specified recursion limit.

Parameter
Name	Description
`recursionLimit`	`Int32` The maximum depth of messages to parse

Settings(Int32, TypeRegistry)

public Settings(int recursionLimit, TypeRegistry typeRegistry)

Creates a new JsonParser.Settings object with the specified recursion limit and type registry.

Parameters
Name	Description
`recursionLimit`	`Int32` The maximum depth of messages to parse
`typeRegistry`	`TypeRegistry` The type registry used to parse Any messages

Properties

Default

public static JsonParser.Settings Default { get; }

Default settings, as used by Default. This has the same default recursion limit as CodedInputStream, and an empty type registry.

Property Value
Type	Description
`JsonParser.Settings`

IgnoreUnknownFields

public bool IgnoreUnknownFields { get; }

Whether the parser should ignore unknown fields (true) or throw an exception when they are encountered (false).

Property Value
Type	Description
`Boolean`

RecursionLimit

public int RecursionLimit { get; }

The maximum depth of messages to parse. Note that this limit only applies to parsing messages, not collections - so a message within a collection within a message only counts as depth 2, not 3.

Property Value
Type	Description
`Int32`

TypeRegistry

public TypeRegistry TypeRegistry { get; }

The type registry used to parse Any messages.

Property Value
Type	Description
`TypeRegistry`

Methods

WithIgnoreUnknownFields(Boolean)

public JsonParser.Settings WithIgnoreUnknownFields(bool ignoreUnknownFields)

Creates a new JsonParser.Settings object set to either ignore unknown fields, or throw an exception when unknown fields are encountered.

Parameter
Name	Description
`ignoreUnknownFields`	`Boolean` `true` if unknown fields should be ignored when parsing; `false` to throw an exception.

Returns
Type	Description
`JsonParser.Settings`

WithRecursionLimit(Int32)

public JsonParser.Settings WithRecursionLimit(int recursionLimit)

Creates a new JsonParser.Settings object based on this one, but with the specified recursion limit.

Parameter
Name	Description
`recursionLimit`	`Int32` The new recursion limit.

Returns
Type	Description
`JsonParser.Settings`

WithTypeRegistry(TypeRegistry)

public JsonParser.Settings WithTypeRegistry(TypeRegistry typeRegistry)

Creates a new JsonParser.Settings object based on this one, but with the specified type registry.

Parameter
Name	Description
`typeRegistry`	`TypeRegistry` The new type registry. Must not be null.

Returns
Type	Description
`JsonParser.Settings`