M Y D E L P H I 7 . R U Самоучитель программирования  
 
  • Главная
  •  

     

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