JsonElement.TryParseValue(Utf8JsonReader, Nullable<JsonElement>) Metoda

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

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

public:
 static bool TryParseValue(System::Text::Json::Utf8JsonReader % reader, [Runtime::InteropServices::Out] Nullable<System::Text::Json::JsonElement> % element);

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

static member TryParseValue : Utf8JsonReader * Nullable -> bool

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef element As Nullable(Of JsonElement)) As Boolean

Parametry

reader

Utf8JsonReader

Czytelnik do czytania.

element

Nullable<JsonElement>

Odbiera przeanalizowany element.

Zwraca

Boolean

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

Wyjątki

ArgumentException

reader używa nieobsługiwanych opcji.

ArgumentException

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 reader wartość PropertyName lub None, czytnik zostanie zaawansowany przez jedno wywołanie, aby Read() określić początek wartości.

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

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