System.JSON.BSON.TBsonReader

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

Delphi

TBsonReader = class(TJsonReader)

C++

class PASCALIMPLEMENTATION TBsonReader : public System::Json::Readers::TJsonReader

Propriétés

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

Description

Classe utilisée pour lire les données sérialisées dans le format BSON.

Pour lire les données BSON :

1. Create crée un lecteur BSON qui lit les données depuis un flux de données.
2. Appelez Read pour que le lecteur se déplace jusqu'au premier token BSON 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.
   • CurrentElementType indique le type BSON de la valeur du token.
   • Value vous donne accès à la valeur du token. Le type d'un token et le type BSON de sa valeur déterminent la méthode de Value que vous devez utiliser pour accéder à la valeur du token. Par exemple, si TokenType vaut PropertyName et CurrentElementType vaut {{Const|String}, 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 au sein des données d'entrée à laquelle se trouve le lecteur.
3. Continuez à appeler Read pour parcourir tous les tokens BSON 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).
• Reader donne accès au lecteur binaire sous-jacent utilisé par le lecteur BSON.
• 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.BSON.TBsonWriter

• System.JSON.Readers.TJsonTextReader