Share via


JsonDocument.ParseValue(Utf8JsonReader) Methode

Definition

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

JsonDocument

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.

Gilt für