JsonDocument.TryParseValue(Utf8JsonReader, JsonDocument) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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
reader
contient des options non prises en charge.
- ou -
Le jeton reader
actuel ne démarre pas et ne représente pas une valeur.
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.