JsonDocument.ParseValue(Utf8JsonReader) 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.
Analysiert einen JSON-Wert (einschließlich Objekte oder Arrays) aus dem angegebenen Reader.
public:
static System::Text::Json::JsonDocument ^ ParseValue(System::Text::Json::Utf8JsonReader % reader);
public static System.Text.Json.JsonDocument ParseValue (ref System.Text.Json.Utf8JsonReader reader);
static member ParseValue : Utf8JsonReader -> System.Text.Json.JsonDocument
Public Shared Function ParseValue (ByRef reader As Utf8JsonReader) As JsonDocument
Parameter
- reader
- Utf8JsonReader
Der Reader zum Lesen.
Gibt zurück
Ein JsonDocument, das den Wert (und geschachtelte Werte) darstellt, die aus dem Reader gelesen werden.
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 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.