JsonDocument.ParseValue(Utf8JsonReader) Methode

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Paket:

System.Text.Json v11.0.0-preview.4.26230.115

Quelle:

JsonDocument.Parse.cs

Analysiert einen JSON-Wert (einschließlich Objekte oder Arrays) vom bereitgestellten 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 leser, der gelesen werden soll.

Gibt zurück

JsonDocument

Ein JsonDocument, das den Wert (und geschachtelte Werte) darstellt, der vom Leser gelesen wird.

Ausnahmen

ArgumentException

reader enthält nicht unterstützte Optionen.

-oder-

Das aktuelle reader Token beginnt nicht oder stellt einen Wert dar.

JsonException

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 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.