TurboDB VCL Component Library

TTdbQuery.Prepare

TTdbQuery

Previous  Top  Next

Sends a query to the TurboDB Engine for optimization prior to execution.

Delphi syntax:

procedure Prepare;

C++ syntax:

void __fastcall Prepare(void);

Description

Call Prepare to have TurboDB allocate resources for the query and to perform additional optimizations. Calling Prepare before executing a query improves application performance.

Delphi automatically prepares a query if it is executed without first being prepared. After execution, Delphi unprepares the query. When a query will be executed a number of times, an application should always explicitly prepare the query to avoid multiple and unnecessary prepares and unprepares.

Preparing a query consumes some database resources, so it is good practice for an application to unprepare a query once it is done using it. The UnPrepare method unprepares a query.

Note

When you change the text of a query at runtime, the query is automatically closed and unprepared.