JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Versucht, einen JSON-Wert (einschließlich Objekte oder Arrays) vom bereitgestellten Reader zu analysieren.
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 -> boolPublic Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef document As JsonDocument) As BooleanParameter
- reader
- Utf8JsonReader
Der leser, der gelesen werden soll.
- document
- JsonDocument
Wenn die Methode zurückgegeben wird, enthält sie das analysierte Dokument.
Gibt zurück
true wenn ein Wert gelesen und in ein JsonDocument analysiert wurde; false wenn der Leser beim Analysieren keine Daten mehr hat. Alle anderen Situationen führen dazu, dass eine Ausnahme ausgelöst wird.
Ausnahmen
reader enthält nicht unterstützte Optionen.
-oder-
Das aktuelle reader Token beginnt nicht oder stellt einen Wert dar.
Ein Wert konnte nicht vom Leser gelesen werden.
Hinweise
Wenn die TokenType Eigenschaft der reader Eigenschaft ist JsonTokenType.PropertyName oder JsonTokenType.None, wechselt der Leser um einen Aufruf, um den Anfang des Werts zu Utf8JsonReader.Read() bestimmen.
Nach Abschluss dieser Methode reader wird am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst oder false zurückgegeben wird, wird der Leser auf den Zustand zurückgesetzt, in dem sie sich befand, als die Methode aufgerufen wurde.
Diese Methode erstellt eine Kopie der Daten, auf die der Leser reagiert hat, sodass es keine Aufruferanforderung gibt, die Datenintegrität über die Rückgabe dieser Methode hinaus aufrechtzuerhalten.
