TDAMacroExpression
Overview
The TDAMacroExpression class s a descendant of the TDAWhereExpression class and used to represent a call to a macro function.
Location
- Unit: uDAWhere.pas
- Ancestry: TDAWhereExpression | TDAMacroExpression
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
Clone override
function Clone: TDAWhereExpression
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
Clone override
function Clone: TDAWhereExpression
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