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

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Paket:

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

Quelle:

JsonElement.Parse.cs

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

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 beim Analysieren keine Daten mehr hat. Alle anderen Situationen führen dazu, dass eine Ausnahme ausgelöst wird.

Ausnahmen

ArgumentException

reader verwendet nicht unterstützte Optionen.

ArgumentException

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 PropertyName oder None, wird der Leser durch einen Aufruf erweitert, um den Anfang des Werts zu Read() bestimmen.

Nach Abschluss dieser Methode reader wird am endgültigen Token im JSON-Wert positioniert. Wenn eine Ausnahme ausgelöst oder false zurückgegeben 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.