JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Méthode

Définition

Espace de noms:

System.Text.Json

Assembly:

System.Text.Json.dll

Tente d’analyser une valeur JSON (notamment des objets ou des tableaux) à partir du lecteur fourni.

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

Paramètres

reader

Utf8JsonReader

Lecteur à partir duquel effectuer la lecture.

document

JsonDocument

Quand la méthode retourne une valeur, contient le document analysé.

Retours

Boolean

true si une valeur a été lue et analysée dans un JsonDocument ; false si le lecteur a manqué de données lors de l’analyse. Toutes les autres situations entraînent la levée d’une exception.

Exceptions

ArgumentException

reader contient des options non prises en charge.

• ou -

Le jeton reader actuel ne démarre pas et ne représente pas une valeur.

JsonException

Une valeur n’a pas pu être lue par le lecteur.

Remarques

Si la TokenType propriété d’est reader JsonTokenType.PropertyName ou JsonTokenType.None, le lecteur passe par un appel pour Utf8JsonReader.Read() déterminer le début de la valeur.

Une fois cette méthode terminée, reader elle est positionnée sur le jeton final dans la valeur JSON. Si une exception est levée ou false retournée, le lecteur est réinitialisé à l’état dans lequel la méthode a été appelée.

Cette méthode effectue une copie des données sur laquelle le lecteur a agi, de sorte qu’il n’existe aucune exigence d’appelant pour maintenir l’intégrité des données au-delà du retour de cette méthode.