TQuery.Prepared Property

Determines whether or not a query is prepared for execution.

Pascal

property Prepared: Boolean;

C++

__property Boolean Prepared;

Description

Examine Prepared to determine if a query is already prepared for execution. If Prepared is true, the query is prepared, and if Prepared is false, the query is not prepared. While a query need not be prepared before execution, execution performance is enhanced if the query is prepared beforehand, particularly if it is a parameterized query that is executed more than once using the same parameter values.

Note: An application can change the current setting of Prepared to prepare or unprepare a query. If Prepared is true, setting it to false calls the UnPrepare method to unprepare the query. If Prepared is false, setting it to true calls the Prepare method to prepare the query. Generally, however, it is better programming practice to call Prepare and UnPrepare directly. These methods automatically update the Prepared property.