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