JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Metoda

Definice

Obor názvů:

System.Text.Json

Sestavení:

System.Text.Json.dll

Balíček:

System.Text.Json v11.0.0-preview.5.26302.115

Zdroj:

JsonDocument.Parse.cs

Pokusí se analyzovat jednu hodnotu JSON (včetně objektů nebo polí) od poskytnutého čtenáře.

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);

static member TryParseValue : Utf8JsonReader * JsonDocument -> bool

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

Parametry

reader

Utf8JsonReader

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

document

JsonDocument

Když metoda vrátí, obsahuje analyzovaný dokument.

Návraty

Boolean

true Pokud byla hodnota načtena a analyzována do jsonDocument; false pokud čtečka při analýze došla z dat. Všechny ostatní situace způsobí vyvolání výjimky.

Výjimky

ArgumentException

reader obsahuje nepodporované možnosti.

nebo

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

JsonException

Hodnotu nelze přečíst ze čtečky.

Poznámky

TokenType Pokud je JsonTokenType.PropertyName vlastnost reader nebo JsonTokenType.None, čtenář přejde o jedno volání, aby Utf8JsonReader.Read() určil začátek hodnoty.

Po dokončení této metody reader se umístí na konečný token v hodnotě JSON. Pokud je vyvolána výjimka nebo false je vrácena, čtenář se resetuje do stavu, ve který byl při zavolání metody.

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