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) aus dem angegebenen 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 Reader zum Lesen.
- document
- JsonDocument
Wenn diese 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 dem Reader beim Analysieren die Daten ausgegangen sind. Alle anderen Fälle führen dazu, dass eine Ausnahme ausgelöst wird.
Ausnahmen
reader enthält nicht unterstützte Optionen.
- oder -
Das aktuelle reader-Token startet nicht oder stellt einen Wert dar.
Es konnte kein Wert aus dem Reader gelesen werden.
Hinweise
Wenn die TokenType Eigenschaft reader JsonTokenType.PropertyName des Werts oder JsonTokenType.None, wird der Leser durch einen Aufruf vorangehen, um Utf8JsonReader.Read() den Anfang des Werts zu bestimmen.
Nach Abschluss dieser Methode reader wird das endgültige Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst false oder zurückgegeben wird, wird der Leser auf den Zustand zurückgesetzt, in dem die Methode aufgerufen wurde.
Diese Methode macht 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 beizubehalten.