<summary>Defines how the <see cref="T:System.Text.Json.Utf8JsonReader" /> struct handles comments.</summary>

<summary>Allows comments within the JSON input and treats them as valid tokens. While reading, the caller can to access the comment values.</summary>

<summary>Doesn't allow comments within the JSON input. Comments are treated as invalid JSON if found, and a <see cref="T:System.Text.Json.JsonReaderException" /> is thrown. This is the default value.</summary>

<summary>Allows comments within the JSON input and ignores them. The <see cref="T:System.Text.Json.Utf8JsonReader" /> behaves as if no comments are present.</summary>

</Type>

<summary>The exception that is thrown when <see cref="T:System.Text.Json.Utf8JsonReader" /> encounters invalid data or data disallowed by any of its options.</summary>

<param name="message">The context-specific error message.</param>

<param name="lineNumber">The line number (starting at 0) at which the invalid JSON was encountered.</param>

<param name="bytePositionInLine">The byte count (starting at 0) in the current line where the invalid JSON was encountered.</param>

<summary>Creates a new exception object to relay error information to the user.</summary>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<summary>Gets the number of bytes read within the current line (starting at 0) before the exception.</summary>

<value>The number of bytes read within the current line (starting at 0) before the exception.</value>

<param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that holds the serialized object data about the exception being thrown.</param>

<param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext" /> that contains contextual information about the source or destination.</param>

<summary>Sets the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> with information about the exception.</summary>

<summary>Gets the number of lines read (starting at 0) before the exception.</summary>

<value>The number of lines read (starting at 0) before the exception.</value>

</Type>

<summary>Provides the ability for the user to define custom behavior when reading JSON.</summary>

<summary>Gets or sets how the <see cref="T:System.Text.Json.Utf8JsonReader" /> struct handles comments when reading through the JSON data.</summary>

<value>One of the enumeration values that indicates how comments are handled.</value>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<summary>Defines an opaque type that holds and saves all the relevant state information, which must be provided to the <see cref="T:System.Text.Json.Utf8JsonReader" /> to continue reading after processing incomplete data.</summary>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<param name="maxDepth">The maximum depth allowed when reading JSON. This is an optional parameter, and its default value is 64. Reading past this depth throws a <see cref="T:System.Text.Json.JsonReaderException" /></param>

<param name="options">The customized behavior of the <see cref="T:System.Text.Json.Utf8JsonReader" /> that is different from the JSON RFC (for example, how to handle comments).

This is an optional parameter and, by default, the <see cref="T:System.Text.Json.Utf8JsonReader" /> struct follows the JSON RFC strictly (that is, comments within the JSON are invalid).</param>

<summary>Initializes a new instance of the <see cref="T:System.Text.Json.JsonReaderState" /> struct.</summary>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<exception cref="T:System.ArgumentException">

<paramref name="maxDepth" /> is less than or equal to 0.</exception>

<summary>Gets the total number of bytes consumed by the <see cref="T:System.Text.Json.Utf8JsonReader" /> so far for the given UTF-8 encoded input text.</summary>

<value>The total number of bytes consumed by the <see cref="T:System.Text.Json.Utf8JsonReader" /> so far.</value>

<summary>Gets the maximum depth allowed when reading JSON.</summary>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<summary>Gets the custom behavior to use when reading JSON data using the <see cref="T:System.Text.Json.Utf8JsonReader" /> struct that may deviate from strict adherence to the JSON specification, which is the default behavior.</summary>

<value>The custom behavior to use when reading JSON data.</value>

<summary>Gets the current <see cref="T:System.SequencePosition" /> within the provided UTF-8 encoded input ReadOnlySequence&lt;byte&gt;. If the <see cref="T:System.Text.Json.Utf8JsonReader" /> struct was constructed

with a ReadOnlySpan&lt;byte&gt; instead, this will always return a default <see cref="T:System.SequencePosition" />.</summary>

<value>The current <see cref="T:System.SequencePosition" /> within the provided UTF-8 encoded input ReadOnlySequence&lt;byte&gt;.</value>

</Type>

<summary>Defines the various JSON tokens that make up a JSON text.</summary>

<summary>Allows the user to define custom behavior when writing JSON using the <see cref="T:System.Text.Json.Utf8JsonWriter" />.</summary>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<summary>Gets or sets a value that indicates whether the <see cref="T:System.Text.Json.Utf8JsonWriter" /> should format the JSON output, which includes indenting nested JSON tokens, adding new lines, and adding white space between property names and values.</summary>

<value><see langword="true" /> to format the JSON output; <see langword="false" /> to write without any extra white space. The default is <see langword="false" />.</value>

<summary>Gets or sets a value that indicates whether the <see cref="T:System.Text.Json.Utf8JsonWriter" /> should skip structural validation and allow the user to write invalid JSON.</summary>

<value><see langword="true" /> to skip structural validation and allow invalid JSON; <see langword="false" /> to throw an <see cref="T:System.InvalidOperationException" /> on any attempt to write invalid JSON.

</value>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<summary>Defines an opaque type that holds and saves all the relevant state information which must be provided to the <see cref="T:System.Text.Json.Utf8JsonWriter" /> struct to continue writing after completing a partial write.</summary>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<param name="options">The customized behavior of the <see cref="T:System.Text.Json.Utf8JsonWriter" /> struct.

By default, the <see cref="T:System.Text.Json.Utf8JsonWriter" /> writes JSON minimized (that is, with no extra white space) and validates that the JSON data being written is structurally valid according to JSON RFC.</param>

<summary>Initializes a new instance of the <see cref="T:System.Text.Json.JsonWriterState" /> struct.</summary>

<remarks>

<format type="text/markdown"><![CDATA[

]]></format>

</remarks>

<summary>Gets the total number of bytes committed to the output by the <see cref="T:System.Text.Json.Utf8JsonWriter" /> struct so far. This indicates how much the <see cref="T:System.Buffers.IBufferWriter`1" /> has advanced.</summary>

<value>The total number of bytes committed to the output.</value>

<summary>Gets the total number of bytes written by the <see cref="T:System.Text.Json.Utf8JsonWriter" /> struct so far. This includes data that has been written beyond what has already been committed.</summary>

<value>The total number of bytes written.</value>

<summary>Gets the custom behavior to use when writing JSON data using the <see cref="T:System.Text.Json.Utf8JsonWriter" /> struct.</summary>

<value>The custom behavior to use when writing JSON data.</value>

</Type>