JsonDocument.ParseValue(Utf8JsonReader) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Text.Json

Zestaw:: System.Text.Json.dll

Pakiet:: System.Text.Json v8.0.3

Pakiet:: System.Text.Json v9.0.0-preview.3.24172.9

Źródło:: JsonDocument.Parse.cs

Źródło:: JsonDocument.Parse.cs

Źródło:: JsonDocument.Parse.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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.

Dotyczy