FireDAC.Phys.MongoDBWrapper.TMongoDocument.Append

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function Append(const ADoc: TMongoDocument): TMongoDocument; overload;
function Append(const AJSON: String): TMongoDocument; overload;
function Append(const AItems: array of const): TMongoDocument; overload;

C++

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

プロパティ

種類 可視性 ソース ユニット
function public
FireDAC.Phys.MongoDBWrapper.pas
FireDAC.Phys.MongoDBWrapper.hpp
FireDAC.Phys.MongoDBWrapper TMongoDocument


説明

指定された内容をこのドキュメントの末尾に追加し、このオブジェクトの参照を返します。

このメソッドを使用して、指定された内容をこのドキュメントに追加することができます。このメソッドはオーバーロードされていて、次の型の内容を追加するために使用できます。

メソッド ヘッダー 説明
 Append(const ADoc: TMongoDocument)

ADoc ドキュメントの内容をこのドキュメントの末尾に追加します。

 Append(const AJSON: String)

AJSON ドキュメントの内容をこのドキュメントの末尾に追加します。

Append(const AItems: array of const)

オープン配列 AItems をこのドキュメントの末尾に追加します。

このオープン配列は "解析済み" の JSON を表します。項目を追加する方法は次のとおりです。

  • キー-値ペアを追加するには、まずはキー名を、続いて値を指定します。
  • 配列要素を追加するには、値のみを指定します。
  • 入れ子オブジェクトを追加するには、キー-値ペアは { と } で囲まれていなければなりません。
  • ネスト配列を追加するには、要素を '[' と ']' で囲む必要があります。

例:

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

明確になるよう以下に例を挙げます。

Delphi の場合:
var
  oDoc: TMongoDocument;
.....
  oDoc.Append('{"coord": [-73.95, 40.77]}');
C++Builder の場合:
...
TMongoDocument *oDoc;
oDoc->Append("{'coord': [-73.95, 40.77]}");

関連項目