Компонент TQuery

Компонент TQuery реализует все основные функции стандартного компонента запроса, описанные в гл. 12. Прямым предком компонента является класс TDBDataSet.

Для подключения к базе данных используется свойство DatabaseName, в котором задается псевдоним BDE или путь к базе данных.

Текст запроса определяется свойством SQL, для задания которого применяется простой редактор, открывающийся при щелчке на кнопке свойства в Инспекторе объектов (рис. 16.6).

Для управления текстом запроса во время выполнения приложения можно использовать возможности класса TStrings.

Основные свойства и методы компонента TQuery представлены в табл. 16.9.

Таблица 16.9. Свойства и методы компонента TQuery

Объявление

Тип

Описание

Свойства

property Constrained: Boolean;

Pb

При значении True запрещает внесение в набор данных таких значений, которые не соответствуют условиям отбора запроса. Применимо для локальных БД

property DataSource: TDataSource;

Pb

Ссылается на компонент TDataSource, из набора данных которого задаются значения параметров

property Local: Boolean;

Ro

Значение True означает, что запрос обращается к локальной таблице

property ParamCheck: Boolean;

Pb

При значении True параметры запроса обновляются при изменении свойства SQL во время выполнения

property ParamCount: Word;

Ro

Возвращает число параметров в запросе

property Params [Index : Word]TParams;

Pb

Индексированный список объектов TParams, каждый из которых соответствует одному параметру запроса

property Prepared: Boolean

Pu

Возвращает результат выполнения операции подготовки запроса к выполнению

property RequestLive: Boolean;

Pu

При значении False результат запроса нельзя редактировать, независимо от того, редактируемый результат или нет. При значении True результат запроса можно редактировать, но только если он "живой"

property RowsAffected: Integer;

Ro

 

Возвращает число модифицированных записей набора данных с момента последнего выполнения запроса

property SQL: TStrings;

Pb

Содержит текст запроса

property SQLBinary: PChar;

Pu

Внутреннее свойство для обеспечения работы с ВОЕ

property StmtHandle: HDBIStmt;

Ro

Возвращает экземпляр объекта, соответствующего запросу в BDE. Используется при прямом вызове функций BDE

property Text: PChar;

Ro

Указатель на символьный массив, содержащий передаваемый в BDE текст запроса

property UniDirectional: Boolean;

Pb

Определяет тип используемого курсора данных

Методы

procedure ExecSQL;

Pu

Выполняет запрос без открытия набора данных

procedure GetDetailLinkFields (MasterFields, DetailFields: TList) ; override;

Pu

Заполняет списки параметров метода экземплярами объектов полей двух таблиц запроса, находящихся в отношении "один-ко-многим"

function ParamByName (const Value: string) : TParam;

Pu

Возвращает ссылку на экземпляр объекта параметра с именем, переданным в параметре Value

procedure Prepare;

PU

Готовит запрос к выполнению

procedure UnPrepare;

Pu

Освобождает ресурсы, занятые при подготовке запроса к выполнению

 

Рис 16.6. Редактор свойства SQL компонента TQuery