TDAColumnMapping
Overview
The TDAColumnMapping class represents an individual column mapping for a specific statement.
Column mappings are used to map fields defined for a data table to specific field names in the back-end database, allowing one data table definition to be the front-end for different database tables.
Location
- Unit: uDACore.pas
- Ancestry: TCollectionItem | TInterfacedCollectionItem | TDAColumnMapping
Assign override
Copies data from a given source.
procedure Assign(aSource: TPersistent)
Parameters:
- aSource: Instance whose properties will be copied
AssignFieldMapping
Assigns the DatasetField, SQLOrigin and TableField.
procedure AssignFieldMapping(aSource: TPersistent)
Parameters:
- aSource: Instance whose properties will be copied
DatasetField
The data table field to which this mapping pertains.
property DatasetField: string read write
GetDisplayName protected override
Returns the name of the column mapping as it appears in the collection editor.
function GetDisplayName: string
QueryInterface protected stdcall (declared in TInterfacedCollectionItem)
Returns a reference to a specified interface if the object supports that interface. This is one of the methods introduced by the IUnknown interface.
function QueryInterface(const IID: TGUID; out Obj: ): HResult
Parameters:
- IID: Identifier of the interface to return
- Obj: Variable to store the returned interface reference to
SQLOrigin
The name of the database column where the data for this field originates. In most cases, this will be identical to the field's name, unless the field was manually renamed or the original query for the data table uses the SQL "AS" keyword to rename fields, such as
SELECT Name AS UserName FROM ...
In the case above, SQLOrigin would be "UserName" while the TableField would be "Name".
The SQLOrigin property will be used to locate the right field in the recordset retrieved from the server, so it must match the output column name in the SELECT statement.
property SQLOrigin: string read write
TableField
The name of the recordset column containing the data for this field. In most cases, this will be identical to the field's Name, unless the field was manually renamed or the original query for the data table uses the SQL "AS" keyword to rename fields, such as
SELECT Name AS UserName FROM ...
In the above case, TableField would be "Name" while the SQLOrigin would be "UserName". The TableField property will be used as field-name in auto-generated INSERT, UPDATE and DELETE statements, as well as in SELECT statements generated by AutoSQL or Dynamic Where, so it must match the physical column in the data table.
property TableField: string read write
DatasetField
The data table field to which this mapping pertains.
property DatasetField: string read write
SQLOrigin
The name of the database column where the data for this field originates. In most cases, this will be identical to the field's name, unless the field was manually renamed or the original query for the data table uses the SQL "AS" keyword to rename fields, such as
SELECT Name AS UserName FROM ...
In the case above, SQLOrigin would be "UserName" while the TableField would be "Name".
The SQLOrigin property will be used to locate the right field in the recordset retrieved from the server, so it must match the output column name in the SELECT statement.
property SQLOrigin: string read write
TableField
The name of the recordset column containing the data for this field. In most cases, this will be identical to the field's Name, unless the field was manually renamed or the original query for the data table uses the SQL "AS" keyword to rename fields, such as
SELECT Name AS UserName FROM ...
In the above case, TableField would be "Name" while the SQLOrigin would be "UserName". The TableField property will be used as field-name in auto-generated INSERT, UPDATE and DELETE statements, as well as in SELECT statements generated by AutoSQL or Dynamic Where, so it must match the physical column in the data table.
property TableField: string read write
Assign override
Copies data from a given source.
procedure Assign(aSource: TPersistent)
Parameters:
- aSource: Instance whose properties will be copied
AssignFieldMapping
Assigns the DatasetField, SQLOrigin and TableField.
procedure AssignFieldMapping(aSource: TPersistent)
Parameters:
- aSource: Instance whose properties will be copied
GetDisplayName protected override
Returns the name of the column mapping as it appears in the collection editor.
function GetDisplayName: string
QueryInterface protected stdcall (declared in TInterfacedCollectionItem)
Returns a reference to a specified interface if the object supports that interface. This is one of the methods introduced by the IUnknown interface.
function QueryInterface(const IID: TGUID; out Obj: ): HResult
Parameters:
- IID: Identifier of the interface to return
- Obj: Variable to store the returned interface reference to