JsonDocument.ParseValue(Utf8JsonReader) Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Źródło:

JsonDocument.Parse.cs

Analizuje jedną wartość JSON (w tym obiekty lub tablice) od dostarczonego czytnika.

public:
 static System::Text::Json::JsonDocument ^ ParseValue(System::Text::Json::Utf8JsonReader % reader);

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

static member ParseValue : Utf8JsonReader -> System.Text.Json.JsonDocument

Public Shared Function ParseValue (ByRef reader As Utf8JsonReader) As JsonDocument

Parametry

reader

Utf8JsonReader

Czytelnik do przeczytania.

Zwraca

JsonDocument

Dokument JsonDocument reprezentujący wartość (i zagnieżdżone wartości) odczytany z czytnika.

Wyjątki

ArgumentException

reader zawiera nieobsługiwane opcje.

-lub-

Bieżący reader token nie uruchamia się ani nie reprezentuje wartości.

JsonException

Nie można odczytać wartości z czytnika.

Uwagi

TokenType Jeśli właściwość ma JsonTokenType.PropertyName wartość reader lub JsonTokenType.None, czytelnik przejdzie przez jedno wywołanie, aby Utf8JsonReader.Read() określić początek wartości.

Po zakończeniu tej metody reader jest umieszczony w końcowym tokenie w wartości JSON. Jeśli zostanie zgłoszony wyjątek, czytnik zostanie zresetowany do stanu, w którym wystąpił podczas wywoływanej metody.

Ta metoda tworzy kopię danych, na których działał czytelnik, więc nie ma wymogu zachowania integralności danych poza zwróceniem tej metody.