FireDAC.Phys.MongoDBWrapper.TMongoExpression.Add

From RAD Studio API Documentation
Jump to: navigation, search

Delphi 

function Add(const AKey: String; const AValue: String): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: Int32): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: Int64): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: Extended): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: Boolean): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: TDateTime): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: TBytes;  ABinaryType: TJsonBinaryType = TJsonBinaryType.Generic): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: TMongoOID): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValue: TJsonOid): TMongoExpression<T>; overload;
function Add(const AKey: string; const AValue: TJsonRegEx): TMongoExpression<T>; overload;
function Add(const AKey: string; const AValue: TJsonDBRef): TMongoExpression<T>; overload;
function Add(const AKey: string; const AValue: TJsonCodeWScope): TMongoExpression<T>; overload;
function Add(const AKey: String; const AValue: TVarRec): TMongoExpression<T>; overload; inline;
function Add(const AKey: String; const AValues: array of const): TMongoExpression<T>; overload;
function Add(const AKey: String; const AValue: Variant): TMongoExpression<T>; overload; inline;

C++ 

TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::UnicodeString AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const int AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const __int64 AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::Extended AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const bool AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::TDateTime AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::DynamicArray<System::Byte> AValue, System::Json::Types::TJsonBinaryType ABinaryType = (System::Json::Types::TJsonBinaryType)(0x0))/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, TMongoOID* const AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::Json::Types::TJsonOid &AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::Json::Types::TJsonRegEx &AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::Json::Types::TJsonDBRef &AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::Json::Types::TJsonCodeWScope &AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::TVarRec &AValue)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::TVarRec *AValues, const int AValues_High)/* overload */;
TMongoExpression__1<T>* __fastcall Add(const System::UnicodeString AKey, const System::Variant &AValue)/* overload */;

Properties

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

Description

Adds a field-value pair or an array element of a specific type and returns a reference to this expression.

Use this method to add a new field-value pair or an array element to a MongoDB expression.

This method is overloaded. Use an appropriated overloaded method to add a field-value pair or an array element of a specific type.

Method Header Description 
 Add(const AKey: String; const AValue: String)

Adds a field-value pair or an array element of String type. 

Add(const AKey: String; const AValue: Int32)

Adds a field-value pair or an array element of Int32 type. 

Add(const AKey: String; const AValue: Int64)

Adds a field-value pair or an array element of Int64 type. 

Add(const AKey: String; const AValue: Extended)

Adds a field-value pair or an array element of Extended type. 

Add(const AKey: String; const AValue: Boolean)

Adds a field-value pair or an array element of Boolean type. 

Add(const AKey: String; const AValue: TDateTime)

Adds a field-value pair or an array element of TDateTime type. 

Add(const AKey: String; const AValue: TBytes;
      ABinaryType: TJsonBinaryType = TJsonBinaryType.Generic)

Adds a field-value pair or an array element of TBytes type. Optionally, you can specify the ABinaryType parameter, which corresponds to BSON binary subtypes. 

Add(const AKey: String; const AValue: TMongoOID)

Adds a field-value pair or an array element of TMongoOID type. 

Add(const AKey: String; const AValue: TJsonOid)

Adds a field-value pair or an array element of TJsonOid type. 

Add(const AKey: String; const AValue: TJsonRegEx)

Adds a field-value pair or an array element of TJsonRegEx type. 

Add(const AKey: String; const AValue: TJsonDBRef)

Adds a field-value pair or an array element of TJsonDBRef type. 

Add(const AKey: String; const AValue: TJsonCodeWScope)

Adds a field-value pair or an array element of TJsonCodeWScope type. 

Add(const AKey: String; const AValue: TVarRec)

Adds a field-value pair or an array element of TVarRec type. 

Add(const AKey: String; const AValues: array of const)

Adds a nested array using the AValues open array as the array elements.

The open array represents a "parsed" JSON. To add various items, do the following:

  • To add a field-value pair, specify the key name, followed by a value
  • To add an array element, specify just a value
  • To add a nested object, its field-value pairs must be surrounded by '{' and '}
  • To add a nested array, its elements must be surrounded by '[' and ']'.

For example:

    • Add('coords', [123.45, 80.90]) -> "coords": [123.45, 80.90]
    • Add('grades', ['{', 'grade', 'A', 'score', 11, '}', '{', 'grade', 'B', 'score', 17, '}']) -> "grades": [{"grade": "A", "score": 11}, {"grade": "B", "score": 17}]
Add(const AKey: String; const AValue: Variant)

Adds a field-value pair or an array element of a type represented by the Variant data type.

NOTE: When you add an array, the AKey value is ignored. For readability, you can specify array index.

See Also

Retrieved from "http://docwiki.embarcadero.com/Libraries/Rio/e/index.php?title=FireDAC.Phys.MongoDBWrapper.TMongoExpression.Add&oldid=736578"