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

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Pokusí se analyzovat jednu hodnotu JSON (včetně objektů nebo polí) od poskytnuté čtečky.

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

Čtenář, který si má přečíst.

element

Nullable<JsonElement>

Přijme parsovaný prvek.

Návraty

Boolean

true pokud byla hodnota načtena a parsována do JsonElementu; false pokud čtečka při analýze nevyčerpala data. Všechny ostatní situace vedou k vyvolání výjimky.

Výjimky

ArgumentException

reader používá nepodporované možnosti.

ArgumentException

Aktuální reader token nespustí ani nepředstavuje hodnotu.

JsonException

Hodnotu nelze přečíst od čtenáře.

Poznámky

TokenType Pokud je vlastnost reader nebo PropertyName None, čtenář bude upřesňující jedním voláním Read() určit začátek hodnoty.

Po dokončení této metody reader se umístí na konečný token v hodnotě JSON. Pokud dojde k vyvolání výjimky nebo false je vrácena, čtečka se resetuje do stavu, ve který byla volána metoda.

Tato metoda vytvoří kopii dat, na která čtečka fungovala, takže neexistuje požadavek volajícího na zachování integrity dat nad rámec vrácení této metody.