FireDAC.Phys.MongoDBWrapper.TMongoExpression.Append

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi 

function Append(const ADoc: TMongoDocument): TMongoExpression<T>; overload; inline;
function Append(const AJSON: String): TMongoExpression<T>; overload; inline;
function Append(const AItems: array of const): TMongoExpression<T>; overload;

C++ 

TMongoExpression__1<T>* __fastcall Append(TMongoDocument* const ADoc)/* overload */;
TMongoExpression__1<T>* __fastcall Append(const System::UnicodeString AJSON)/* overload */;
TMongoExpression__1<T>* __fastcall Append(const System::TVarRec *AItems, const int AItems_High)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
FireDAC.Phys.MongoDBWrapper.pas
FireDAC.Phys.MongoDBWrapper.hpp
 FireDAC.Phys.MongoDBWrapper TMongoExpression


Description

Ajoute un contenu spécifié à la fin de cette expression et renvoie une référence à cette expression.

Utilisez cette méthode pour ajouter un contenu spécifié à cette expression. Cette méthode est surchargée et peut être utilisée pour l'ajout de contenu des types suivants :

En-tête de méthode Description 
 Append(const ADoc: TMongoDocument)

Ajoute le contenu du document ADoc à la fin de cette expression. 

 Append(const AJSON: String)

Ajoute le contenu du document AJSON à la fin de cette expression. 

Append(const AItems: array of const)

Ajoute un tableau ouvert AItems à la fin de cette expression.

Le tableau ouvert représente un JSON "analysé". Pour ajouter plusieurs éléments, procédez comme suit :

  • Pour ajouter une paire clé-valeur, spécifiez le nom de la clé en le faisant suivre par la valeur.
  • Pour ajouter un élément de tableau, spécifiez simplement une valeur.
  • Pour ajouter un objet imbriqué, ses paires clé-valeur doivent être encadrées par '{' et '}.
  • Pour ajouter un tableau imbriqué, ses éléments doivent être encadrés par '[' et ']'.

Par exemple :

  • Append('coords', [123.45, 80.90]) -> "coords": [123.45, 80.90]
  • Append('grades', ['{', 'grade', 'A', 'score', 11, '}', '{', 'grade', 'B', 'score', 17, '}']) -> "grades": [{"grade": "A", "score": 11}, {"grade": "B", "score": 17}]

Exemples

A titre explicatif, prenons les exemples suivants :

Delphi :
var
  oExp: TMongoExpression;
.....
  oExp.Append('{"coord": [-73.95, 40.77]}');
C++Builder : 
...
TMongoExpression *oExp;
oExp->Append("{'coord': [-73.95, 40.77]}");

Voir aussi

Récupérée de « http://docwiki.embarcadero.com/Libraries/Sydney/f/index.php?title=FireDAC.Phys.MongoDBWrapper.TMongoExpression.Append&oldid=690215 »