Sdílet prostřednictvím


JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Metoda

Definice

Pokusí se analyzovat jednu hodnotu JSON (včetně objektů nebo polí) od zadané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);
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ý si má přečíst.

document
JsonDocument

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

Návraty

Boolean

true pokud byla hodnota načtena a analyzována do formátu 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

reader obsahuje nepodporované možnosti.

-nebo-

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

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

Poznámky

TokenType Pokud je vlastnost reader nebo JsonTokenType.PropertyName 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 není nutné udržovat integritu dat nad rámec vrácení této metody.

Platí pro