System.JSON.Builders.TJSONCollectionBuilder.TPairs.AddPairs

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function AddPairs(const APairs: array of const): TPairs; overload;
function AddPairs(const ABuilder: TJSONCollectionBuilder): TPairs; overload; inline;
function AddPairs(const AJSON: string): TPairs; overload; inline;

C++

HIDESBASE TJSONCollectionBuilder::TPairs* __fastcall AddPairs(System::TVarRec const *APairs, const int APairs_High)/* overload */;
HIDESBASE TJSONCollectionBuilder::TPairs* __fastcall AddPairs(TJSONCollectionBuilder* const ABuilder)/* overload */;
HIDESBASE TJSONCollectionBuilder::TPairs* __fastcall AddPairs(const System::UnicodeString AJSON)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.JSON.Builders.pas
System.JSON.Builders.hpp
System.JSON.Builders TPairs


Description

Ajoute les paires clé-valeur spécifiées à l'objet JSON, et renvoie cette instance de TPairs pour le chaînage de méthode (EN).

Vous pouvez spécifier les paires clé-valeur sous la forme d'un constructeur JSON, d'une chaîne JSON ou d'un tableau de constantes.

Si vous utilisez un tableau de constantes, la première valeur est utilisée comme une clé, la seconde valeur est utilisée comme sa valeur et la troisième valeur est utilisée comme une nouvelle clé, et ainsi de suite. Vous pouvez également utiliser les chaînes "{", "}", "[" et "]" comme éléments du tableau pour indiquer le début et la fin des tableaux et des objets. Par exemple :

Delphi :

MyPairs.AddPairs(['key 1', 'value 1',
                  'key 2', '[',
                    'array',
                    'value',
                    '2',
                  ']',
                  'key 3', '{', 
                    'key 3.1',
                    'value 3.1',
                  '}']);

C++ :

MyPairs->AddPairs(ARRAYOFCONST((String("key 1"), String("value 1"),
                                String("key 2"), String("["),
                                  String("array"),
                                  String("value"),
                                  String("2"),
                                String("]"),
                                String("key 3"), String("{"),
                                  String("key 3.1"),
                                  String("value 3.1"),
                                String("}")])));

Les exemples ci-dessus remplissent l'objet JSON avec les paires clé-valeur suivantes :

"key 1": "value 1",
"key 2": [
  "array",
  "value",
  "2"
],
"key 3": { 
  "key 3.1": "value 3.1"
}

Voir aussi