JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Próbuje przeanalizować jedną wartość JSON (w tym obiekty lub tablice) z dostarczonego czytnika.

public:
 static bool TryParseValue(System::Text::Json::Utf8JsonReader % reader, [Runtime::InteropServices::Out] System::Text::Json::JsonDocument ^ % document);

public static bool TryParseValue (ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonDocument? document);

public static bool TryParseValue (ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonDocument document);

static member TryParseValue : Utf8JsonReader * JsonDocument -> bool

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef document As JsonDocument) As Boolean

Parametry

reader

Utf8JsonReader

Czytelnik do przeczytania.

document

JsonDocument

Gdy metoda zwraca wartość , zawiera przeanalizowany dokument.

Zwraca

Boolean

true jeśli wartość została odczytowana i przeanalizowana w JsonDocument; false jeśli czytnik zabrakło danych podczas analizowania. Wszystkie inne sytuacje powodują zgłoszenie wyjątku.

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 zgłaszany jest wyjątek lub false jest zwracany, czytnik jest resetowany 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.