JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) 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 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

ArgumentException

reader obsahuje nepodporované možnosti.

-nebo-

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

JsonException

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.