Компонент TIBSQL

Компонент TIBSQL предназначен для быстрого выполнения запросов SQL, поэтому не обеспечивает связи с компонентами представления данных (свойства и методы описаны в табл. 18.6).

Для обеспечения скорости выполнения запроса из компонента удалены все дополнительные механизмы, обслуживающие набор данных. Фактически компонент Т1В8С>Ь не имеет отношения к обычным компонентам доступа к данным, его непосредственным предком является класс тсотропепг, а не ТОа1а8е1. Поэтому он только передает через компонент соединения ТЛВВа1аЬа8е запрос серверу и получает назад результат выполнения запроса.

Для повышения скорости компонент не обеспечивает полноценной навигации по набору данных. Перемещение по набору данных возможно только в прямом направлении (однонаправленный курсор).

Возвращаемые набором данных текущие значения полей содержатся не в привычном наборе объектов полей ТГ1е1с1, а в объекте ТТВЖСДЛЭА (см. выше). Так как структура ЖС^ША создается сервером при выполнении запроса, существенно уменьшается время открытия набора данных компонента.

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

Объявление

Тип

Описание

Свойства

property Bof: Boolean;

Pu

Значение True говорит о том, что курсор находится в начале набора данных

property Database: TiBDatabase;

Pb I Определяет компонент соединения i с базой данных

property DBHandle: PISC DB_HANDLE;

Pu

Указатель API на объект базы данных

property Eof: Boolean;

Pu

Значение True говорит о том, что курсор находится в конце набора данных

property Fieldlndex: [FieldName: String] : Integer;

Pu

Список порядковых номеров полей по их именам

property Fields[const Idx:

Integer] : TIBXSQLVAR;

Pu

Индексированный списокструктур XSQLVAR, хранящих значения полей набора данных

property GenerateParamNames:

Boolean;

Pu

Установка свойства в значение True приводит к созданию списка имен параметров запроса в свойстве Params

property GoToFirstRecordOnExecute:

Boolean;

! Pb

Значение True обеспечивает установку курсора на первую запись набора данных при его открытии

property Handle: TISC_STMT_HANDLE;

Pu

Содержит указатель API на запрос

Таблица 18.6 (продолжение)

Объявление

j Тип

Описание

property Open: Boolean;

Pu

Позволяет определить, открыт ли набор данных

property ParamCheck: Boolean;

Pb

Позволяет определить, был ли заново сгенерирован список параметров запроса при изменении его текста во время выполнения

property Params: TIBXSQLDA;

Pu

Область дескрипторов запроса (см.выше)

property Plan: String;

Pu

Содержит план запроса после его подготовки

property Prepared: Boolean;

Pu

Значение True сообщает о том, что запрос готов к выполнению

property RecordCount: Integer;

Pu

Возвращает число записей набора I данных

property RowsAffected: Integer;

Pu

Возвращает число записей, ! обработанных запросом

property SQL: TStrings;

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

property SQLType: TIBSQLTypes read FSQLType;

Pu I Возвращает тип запроса (см. табл. 24.5)

property Transaction: TIBTransaction;

Pb

Указывает на компонент транзакции

property TRHandle: PIS C_TR_HANDLE;

Pu

Содержит указатель АР1 на транзакцию, в которой работает запрос

property UniqueRelationName: String;

Pu

Возвращает уникальное внутреннее имя запроса

Методы

procedure Batchlnput(InputObject: TIBBatchlnput);

Pu

Вьполняет запрос с гтараметрами I для переноса в сбьэкт1при±оь з есь

procedure BatchOutput(OutputObject:

TIBBatchOutput);

Pu

Вьполняет запрос с параметрами дляпереноса в сбъектОиЬриШЬ з

function Call(ErrCode:

ISC_STATUS;
RaiseError: Boolean): ISC_STATUS;

Pu 1

. Возвращает текст сообщения об ошибке I по ее коду ЕггСссТе

procedure CheckClosed;

Pu

Вызывает исключение, если набор данных открыт

Таблица 18.6 (окончание)


⇐ Предыдущая страница| |Следующая страница ⇒

Программирование в Delphi 7



Новости за месяц

  • Август
    2017
  • Пн
  • Вт
  • Ср
  • Чт
  • Пт
  • Сб
  • Вс