System.JSON.Readers.TJsonTextReader

• Aller au parent : System.JSON.Readers
• Méthodes
• Propriétés
• Champs
• Types

Delphi

TJsonTextReader = class(TJsonReader)

C++

class PASCALIMPLEMENTATION TJsonTextReader : public TJsonReader

Propriétés

Type	Visibilité	Source	Unité	Parent
class	public	System.JSON.Readers.pas System.JSON.Readers.hpp	System.JSON.Readers	System.JSON.Readers

Description

Classe permettant de lire les données sérialisées au format JSON.

Pour lire les données JSON :

1. A l'aide de la propriété Create, créez un lecteur JSON qui lit les données à partir du lecteur de texte.
2. Appelez Read pour que le lecteur se déplace jusqu'au premier token JSON des données d'entrée.
   • TokenType indique le type du token. Vous pouvez également utiliser IsPrimitiveToken, IsStartToken ou IsEndToken afin de déterminer si le type du token appartient à un ensemble spécifique de types de tokens ou non.
   • Value vous donne accès à la valeur d'un token. Le type d'un token détermine le type de sa valeur, qui détermine la méthode Value que vous devez utiliser pour accéder à la valeur du token. Par exemple, si TokenType vaut PropertyName, vous devez appeler Value.AsString pour accéder à un nom de propriété.
   • CurrentState indique l'état du lecteur.
   • LineNumber et LinePosition indiquent la position à laquelle se trouve le lecteur au sein des données d'entrée.
3. Continuez à appeler Read pour parcourir tous les tokens JSON des données d'entrée. Read renvoie False quand elle atteint la fin des données d'entrée.
4. Lorsque vous avez fini de lire les données d'entrée, vous pouvez soit fermer, soit détruire le lecteur.

Au lieu d'utiliser Read, vous pouvez alternativement utiliser n'importe laquelle des méthodes de lecture suivantes si vous êtes en mesure d'anticiper le type du prochain token :

• ReadAsBytes
• ReadAsDateTime
• ReadAsDouble
• ReadAsInt64
• ReadAsInteger
• ReadAsString

TJsonTextReader fournit également des fonctionnalités additionnelles :

• CloseInput détermine si le lecteur ferme le lecteur de flux qui fournit les données d'entrée lorsque vous fermez le lecteur (True) ou non (False).
• Rewind réinitialise le lecteur à l'état qu'il a lorsque vous le créez, mais il ne rembobine pas le lecteur de flux qui fournit les données d'entrée.

Voir aussi

• System.JSON.Writers.TJsonTextWriter

• System.JSON.BSON.TBsonReader