Share via


JsonElement.TryParseValue(Utf8JsonReader, Nullable<JsonElement>) Methode

Definition

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] Nullable<System::Text::Json::JsonElement> % element);
public static bool TryParseValue (ref System.Text.Json.Utf8JsonReader reader, out System.Text.Json.JsonElement? element);
static member TryParseValue : Utf8JsonReader * Nullable -> bool
Public Shared Function TryParseValue (ByRef reader As Utf8JsonReader, ByRef element As Nullable(Of JsonElement)) As Boolean

Parameter

reader
Utf8JsonReader

Der Reader zum Lesen.

element
Nullable<JsonElement>

Empfängt das analysierte Element.

Gibt zurück

Boolean

true wenn ein Wert gelesen und in ein JsonElement analysiert wurde; false wenn der Leser während der Analyse Daten ausgelaufen ist. Alle anderen Fälle führen dazu, dass eine Ausnahme ausgelöst wird.

Ausnahmen

reader verwendet nicht unterstützte Optionen.

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 der Eigenschaft reader ist PropertyName oder None, wird der Leser von einem Aufruf erweitert, um Read() den Anfang des Werts zu ermitteln.

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