Компонент 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