FireDAC.Phys.MongoDBWrapper.TMongoExpression.Append

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
FireDAC.Phys.MongoDBWrapper.pas
FireDAC.Phys.MongoDBWrapper.hpp
FireDAC.Phys.MongoDBWrapper TMongoExpression


Beschreibung

Hängt einen angegebenen Inhalt an das Ende dieses Ausdrucks an und gibt eine Referenz auf diesen Ausdruck zurück.

Mit dieser Methode hängen Sie einen angegebenen Inhalt an diesen Ausdruck an. Diese Methode ist überladen und kann zum Hinzufügen von Inhalt mit den folgenden Typen verwendet werden:

Methoden-Header Beschreibung
 Append(const ADoc: TMongoDocument)

Hängt den Inhalt des Dokuments ADoc an das Ende dieses Ausdrucks an.

 Append(const AJSON: String)

Hängt den Inhalt des Dokuments AJSON an das Ende dieses Ausdrucks an.

Append(const AItems: array of const)

Hängt ein offenes AItems-Array an das Ende dieses Ausdrucks an.

Das offene Array repräsentiert "analysiertes" JSON. Führen Sie Folgendes aus, um Elemente hinzuzufügen:

  • Um ein Schlüssel/Wertepaar hinzuzufügen, geben Sie den Schlüsselnamen gefolgt von einem Wert an.
  • Um ein Array-Element hinzuzufügen, geben Sie einfach einen Wert an.
  • Um ein verschachteltes Objekt hinzuzufügen, müssen dessen Schlüssel/Wertepaare in "{" und "}" eingeschlossen sein.
  • Um ein verschachteltes Array hinzuzufügen, müssen dessen Elemente in "[" und "]" eingeschlossen sein.

Zum Beispiel:

  • 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}]

Beispiele

Sehen Sie sich zur Klärung die folgenden Beispiele an:

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

Siehe auch