RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TUpdateSQL.InsertSQL Property

Specifies the SQL INSERT statement to use when applying a cached insertion of a record.

Pascal
property InsertSQL: TStrings;
C++
__property TStrings InsertSQL;

Set InsertSQL to the SQL INSERT statement to use when applying an insertion to a dataset. Statements can be parameterized queries. To create a INSERT statement at design time, use the UpdateSQL editor to create statements, such as:

INSERT INTO "Country.db"
(Name, Capital, Continent)
VALUES (:Name, :Capital, :Continent)
WHERE :OLD_Name = "Rangoon"

At run time, an application can write a statement directly to this property to set or change the INSERT statement.

Note: As the example illustrates, InsertSQL supports an extension to normal parameter binding. To retrieve the value of a field as it exists prior to application of cached updates, the field name with 'OLD_'. This is especially useful when doing field comparisons in the WHERE clause of the statement.
 

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!