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) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!