REST.Json.TJson.ObjectToJsonString

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

class function ObjectToJsonString(AObject: TObject; AOptions: TJsonOptions = [joDateIsUTC, joDateFormatISO8601]): string;

C++

__classmethod System::UnicodeString __fastcall ObjectToJsonString(System::TObject* AObject, TJsonOptions AOptions = (TJsonOptions() << TJsonOption::joDateIsUTC << TJsonOption::joDateFormatISO8601 ));

Propriétés

Type Visibilité  Source Unité  Parent
function public
REST.Json.pas
REST.Json.hpp
REST.Json TJson


Description

Renvoie une chaîne JSON qui représente le descendant de TObject spécifié.

Options JSON

ObjectToJsonString accepte un jeu d'options facultatif, AJsonOptions, qui détermine comment ObjectToJsonString interprète les données de AObject et restitue ces données dans la chaîne JSON résultante.

Le tableau ci-dessous décrit toutes les options JSON disponibles que vous pouvez spécifier. ObjectToJsonString utilise joDateIsUTC et joDateFormatISO8601 si vous ne spécifiez pas une valeur personnalisée pour AJsonOptions.

Option Description

joDateFormatISO8601

Formate les dates en utilisant le standard ISO 8601. Par exemple : "2014-12-01T13:14:18Z" (Mon, 01 Dec 2014 13:14:18 UTC).

joDateFormatMongo

Formate les dates au format MongoDB Extended JSON. Par exemple : { "$date": "2014-12-01T13:14:18.000+00:00" } (Mon, 01 Dec 2014 13:14:18 UTC).

joDateFormatUnix

Formate les dates au format horaire Unix. Par exemple : "1417439658" (Mon, 01 Dec 2014 13:14:18 UTC).

joDateIsUTC

Les heures incluses dans AObject utilisent le standard horaire UTC.

Si vous ne spécifiez pas cette option, ObjectToJsonString suppose que les heures incluses dans AObject utilisent le fuseau horaire local de votre système.

joIgnoreEmptyArrays

N'inclut pas les paires clé-valeur des objets JSON lorsque la valeur d'une paire est un tableau JSON vide.

Par exemple, si AObject peut être sérialisé en utilisant JSON tel que { "clé1": [], "clé2": "valeur2" }, l'option joIgnoreEmptyArrays crée à la place le code JSON résultant { "clé2": "valeur2" }.

joIgnoreEmptyStrings

N'inclut pas les paires clé-valeur des objets JSON lorsque la valeur d'une paire est une chaîne vide.

Par exemple, si AObject peut être sérialisé en utilisant JSON tel que { "clé1": "valeur1", "clé2": "" }, l'option joIgnoreEmptyStrings crée à la place le code JSON résultant { "clé1": "valeur1" }.

Voir aussi