TJsonObject

Classe

type TJsonObject = class(TJson)

Représente un objet JSON. Contient zéro ou plusieurs éléments sous forme de paires nom/valeur. On peut accéder à la liste des membres par nom ou par index.

Caractéristiques

MemberCount : Integer read;

Renvoie le nombre d'éléments contenus dans l'objet.

MemberName[Index : Integer] : WideString en lecture et en écriture ;

Définit ou récupère le nom du membre spécifié.

MemberValue[Index : Integer] : TJson en lecture et en écriture ;

Définit ou renvoie la valeur de l'élément spécifié.

Membres[const Nom : WideString] : TJson lecture-écriture ; par défaut ;

Définit ou récupère l'élément spécifié. Renvoie nil si l'élément n'est pas trouvé.

NullItem[const Name: WideString] : TJsonNull read ;

FalseItem[const Name: WideString] : TJsonFalse read ;

TrueItem[const Name: WideString] : TJsonTrue read ;

ObjectItem[const Name: WideString] : TJsonObject read ;

StringItem[const Name: WideString] : TJsonString read ;

ArrayItem[const Name: WideString] : TJsonArray read ;

NumberItem[const Name: WideString]: TJsonNumber read;

Renvoie l'élément spécifié si le nom est valide et si le type demandé correspond au contenu.

Méthodes

constructor Create ;

Crée une instance de TJsonObject.

procédure DeleteAll ;

Supprime tous les membres.

procédure Delete(Index : Integer) ; surcharge ;

procédure Delete(const Name : WideString) ; surcharge ;

Supprime le membre spécifié.

function Find(const Name: WideString): Integer;

Renvoie l'index de l'élément spécifié. Renvoie -1 si l'élément n'est pas trouvé.

function SetArray(const Name: WideString; ElementCount: Integer): TJsonArray;

procedure SetDateTime(const Name: WideString; const Value: TDateTime; Offset: Integer = 0);

procedure SetFalse(const Name: WideString);

function SetJson(const Name: WideString; Value: TJson): TJson;

procedure SetNull(const Name: WideString);

procedure SetNumber(const Name: WideString; Value: Double);

function SetObject(const Name: WideString): TJsonObject;

procedure SetString(const Name: WideString; const Value: WideString);

procedure SetTrue(const Name: WideString);

Les méthodes Set permettent de créer ou de convertir l'élément spécifié en le type et la valeur indiqués. Les fonctions SetArray, SetJson et SetObject renvoient des instances des éléments nouvellement modifiés afin de permettre leur manipulation ultérieure.

Exemple

jObject = TJsonObject.Create 'Crée un objet vide
showmessage(jObject.MemberCount) 'affiche 0

jObject.SetNull("Null")
showmessage(jObject.MemberCount) 'affiche 1

jObject.SetFalse("False")
showmessage(jObject.MemberCount) 'affiche 2

jObject.DeleteAll
showmessage(jObject.MemberCount) 'affiche 0 |