TDAMacroExpression

Overview

The TDAMacroExpression class s a descendant of the TDAWhereExpression class and used to represent a call to a macro function.

Location

 

constructor Create  overload

Creates a new expression.

constructor Create

constructor Create (string)  overload

Creates a new expression and initializes its Name property.

constructor Create(const aName: string)

Parameters:

  • aName: Name of macro.

constructor Create (string, array of TDAWhereExpression)  overload

Creates a new expression and initializes its Name property. The method also intializes a list of macro parameters.

constructor Create(const aName: string; const aValues: array of TDAWhereExpression)

Parameters:

  • aName: Name of macro.
  • aValues: array of expressions.

Add

Adds the provided TDAWhereExpression instance to the list of macro parameter values.

procedure Add(aValue: TDAWhereExpression)

Parameters:

  • aValue: expression.

AsJson    (declared in TDAWhereExpression)

Returns where expression in Json format

function AsJson: UnicodeString

AsXML    (declared in TDAWhereExpression)

Returns where expression in XML format

function AsXML: UnicodeString

Clear

Clears Items collection

procedure Clear

Count

Gets a count of the defined macro parameters.

property Count: Integer read

Delete

Deletes the TDAWhereExpression instance by the index from the macro parameter list.

procedure Delete(index: Integer)

Parameters:

  • index: position

DoValidate  protected    (declared in TDAWhereExpression)

Raised exception if aRaiseException is set

procedure DoValidate(aRaiseException: Boolean; aName: string)

Parameters:

  • aRaiseException: specifies should the exception be raised or not.
  • aName: Name of property

Insert

Inserts the provided TDAWhereExpression instance into the list of macro parameter values at the Position position.

procedure Insert(Position: Integer; aValue: TDAWhereExpression)

Parameters:

  • Position: position
  • aValue: expression.

Item

Gets or sets a macro parameter at the index position.

property Item[idx: Integer]: TDAWhereExpression read write

Kind    (declared in TDAWhereExpression)

Specified kind of TDAWhereExpression

property Kind: TDAWhereKind read

Name

Name of the macro expression.

property Name: string read write

ParseException  protected    (declared in TDAWhereExpression)

Raises EDAWhereParseXmlException.

procedure ParseException(aName: string)

Parameters:

  • aName: property name.

ParseExpression (TROJSONObject, string): TDAWhereExpression  protected overload    (declared in TDAWhereExpression)

Creates new Where expression from Json object.

function ParseExpression(aItem: TROJSONObject; aName: string): TDAWhereExpression

Parameters:

  • aItem: Json object
  • aName: Name of property

ParseExpression (IXmlNode, string): TDAWhereExpression  protected overload    (declared in TDAWhereExpression)

Creates new Where expression from XML node.

function ParseExpression(xr: IXmlNode; aName: string): TDAWhereExpression

Parameters:

  • xr: source node.
  • aName: Name of property

ParseExpression (TROJSONObject): TDAWhereExpression  overload    (declared in TDAWhereExpression)

Creates new Where expression from Json object.

class function ParseExpression(anItem: TROJSONObject): TDAWhereExpression

Parameters:

  • anItem: json object

ParseExpression (IXmlNode): TDAWhereExpression  overload    (declared in TDAWhereExpression)

Creates new Where expression from XML node.

class function ParseExpression(xr: IXmlNode): TDAWhereExpression

Parameters:

  • xr: given XML node.

ReadFromJson  override

Reads where expression from the Json.

procedure ReadFromJson(aItem: TROJSONObject)

Parameters:

  • aItem: Json object

ReadFromXml  override

Reads where expression from the XML.

procedure ReadFromXml(xr: IXmlNode)

Parameters:

  • xr: source node

Remove

Removes the provided TDAWhereExpression instance from the macro parameters list.

procedure Remove(aValue: TDAWhereExpression)

Parameters:

  • aValue: expression.

RemoveEmptyNodes    (declared in TDAWhereExpression)

Removes empty XML nodes from given node

class procedure RemoveEmptyNodes(aNode: IXMLNode)

Parameters:

  • aNode: node

Validate  override

Validates properties of expression.

procedure Validate

WriteToJson  override

Writes where expression to the Json object.

procedure WriteToJson(aItem: TROJSONObject)

Parameters:

  • aItem: destination object

WriteToXml  override

Writes where expression to the XML node.

procedure WriteToXml(sw: IXmlNode)

Parameters:

  • sw: destination node

 

Count

Gets a count of the defined macro parameters.

property Count: Integer read

Item

Gets or sets a macro parameter at the index position.

property Item[idx: Integer]: TDAWhereExpression read write

Kind    (declared in TDAWhereExpression)

Specified kind of TDAWhereExpression

property Kind: TDAWhereKind read

Name

Name of the macro expression.

property Name: string read write

 

ParseExpression (TROJSONObject): TDAWhereExpression  overload    (declared in TDAWhereExpression)

Creates new Where expression from Json object.

class function ParseExpression(anItem: TROJSONObject): TDAWhereExpression

Parameters:

  • anItem: json object

ParseExpression (IXmlNode): TDAWhereExpression  overload    (declared in TDAWhereExpression)

Creates new Where expression from XML node.

class function ParseExpression(xr: IXmlNode): TDAWhereExpression

Parameters:

  • xr: given XML node.

RemoveEmptyNodes    (declared in TDAWhereExpression)

Removes empty XML nodes from given node

class procedure RemoveEmptyNodes(aNode: IXMLNode)

Parameters:

  • aNode: node

 

constructor Create  overload

Creates a new expression.

constructor Create

constructor Create (string)  overload

Creates a new expression and initializes its Name property.

constructor Create(const aName: string)

Parameters:

  • aName: Name of macro.

constructor Create (string, array of TDAWhereExpression)  overload

Creates a new expression and initializes its Name property. The method also intializes a list of macro parameters.

constructor Create(const aName: string; const aValues: array of TDAWhereExpression)

Parameters:

  • aName: Name of macro.
  • aValues: array of expressions.

Add

Adds the provided TDAWhereExpression instance to the list of macro parameter values.

procedure Add(aValue: TDAWhereExpression)

Parameters:

  • aValue: expression.

AsJson    (declared in TDAWhereExpression)

Returns where expression in Json format

function AsJson: UnicodeString

AsXML    (declared in TDAWhereExpression)

Returns where expression in XML format

function AsXML: UnicodeString

Clear

Clears Items collection

procedure Clear

Delete

Deletes the TDAWhereExpression instance by the index from the macro parameter list.

procedure Delete(index: Integer)

Parameters:

  • index: position

DoValidate  protected    (declared in TDAWhereExpression)

Raised exception if aRaiseException is set

procedure DoValidate(aRaiseException: Boolean; aName: string)

Parameters:

  • aRaiseException: specifies should the exception be raised or not.
  • aName: Name of property

Insert

Inserts the provided TDAWhereExpression instance into the list of macro parameter values at the Position position.

procedure Insert(Position: Integer; aValue: TDAWhereExpression)

Parameters:

  • Position: position
  • aValue: expression.

ParseException  protected    (declared in TDAWhereExpression)

Raises EDAWhereParseXmlException.

procedure ParseException(aName: string)

Parameters:

  • aName: property name.

ParseExpression (TROJSONObject, string): TDAWhereExpression  protected overload    (declared in TDAWhereExpression)

Creates new Where expression from Json object.

function ParseExpression(aItem: TROJSONObject; aName: string): TDAWhereExpression

Parameters:

  • aItem: Json object
  • aName: Name of property

ParseExpression (IXmlNode, string): TDAWhereExpression  protected overload    (declared in TDAWhereExpression)

Creates new Where expression from XML node.

function ParseExpression(xr: IXmlNode; aName: string): TDAWhereExpression

Parameters:

  • xr: source node.
  • aName: Name of property

ReadFromJson  override

Reads where expression from the Json.

procedure ReadFromJson(aItem: TROJSONObject)

Parameters:

  • aItem: Json object

ReadFromXml  override

Reads where expression from the XML.

procedure ReadFromXml(xr: IXmlNode)

Parameters:

  • xr: source node

Remove

Removes the provided TDAWhereExpression instance from the macro parameters list.

procedure Remove(aValue: TDAWhereExpression)

Parameters:

  • aValue: expression.

Validate  override

Validates properties of expression.

procedure Validate

WriteToJson  override

Writes where expression to the Json object.

procedure WriteToJson(aItem: TROJSONObject)

Parameters:

  • aItem: destination object

WriteToXml  override

Writes where expression to the XML node.

procedure WriteToXml(sw: IXmlNode)

Parameters:

  • sw: destination node