JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Methode

Referenz

Definition

Namespace:: System.Text.Json

Assembly:: System.Text.Json.dll

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

Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef document As JsonDocument) As Boolean

Parameter

reader: Utf8JsonReader

Der Reader zum Lesen.

document: JsonDocument

Wenn diese Methode zurückgegeben wird, enthält sie das analysierte Dokument.

Gibt zurück

Boolean

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

ArgumentException

reader enthält nicht unterstützte Optionen.

- oder -

Das aktuelle reader-Token startet nicht oder stellt einen Wert dar.

JsonException

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.

Gilt für