JsonElement.ParseValue(Utf8JsonReader) Method

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Source:

JsonElement.Parse.cs

Parses one JSON value (including objects or arrays) from the provided reader.

C#

public static System.Text.Json.JsonElement ParseValue(ref System.Text.Json.Utf8JsonReader reader);

Parameters

reader

Utf8JsonReader

The reader to read.

Returns

JsonElement

A JsonElement representing the value (and nested values) read from the reader.

Exceptions

ArgumentException

reader is using unsupported options.

ArgumentException

The current reader token does not start or represent a value.

JsonException

A value could not be read from the reader.

Remarks

If the TokenType property of reader is PropertyName or None, the reader will be advanced by one call to Read() to determine the start of the value.

Upon completion of this method, reader is positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called.

This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method.

Applies to