Справочник по компонентам Delphi. Часть 3
Страница 24. Компонент TStoredProc


Компонент TStoredProc

TObject->TPersistent->TCornponent-”TDataSet-^TDBDataSet-”TStoredProc Модуль DBTABLES Страница Палитры компонентов Data Access

Позволяет приложению использовать хранимые процедуры сервера базы дан­ных. Хранимые процедуры являются разновидностью метаданных и могут возвращать как единичные записи, так и наборы данных. TStoredProc имеет

много общего с другими дочерними компонентами объекта TDataSet, поэтому ниже будут описаны только уникальные свойства и методы компонента, все общие параметры рассматриваются выше.

Свойства компонента

(РЬ) property Overload: Word;

Предназначено для использования пакетов хранимых процедур серверов Oracle. Означает порядковый номер используемой перезагружаемой хранимой процедуры. Значение по умолчанию — 0.

(Pb) property ParamBindMode: TTParamBindMode; TParamBindMode = (pbByName, pbByNumber) ;

Определяет, каким образом элементы массива свойства Params будут связаны с параметрами хранимой процедуры. Значение pbByName подразумевает расположение параметров по именам; pbByNumber располагает параметры в порядке их определения в хранимой процедуре.

(Ro) property ParamCount:Word;

Определяет общее число передаваемых и получаемых параметров хранимой процедуры.

(Pb) property Params: TParams;

Содержит массив параметров хранимой процедуры.

property Prepared: Boolean;

В значении True инициирует процесс оптимизации хранимой процедуры на сервере. Аналогично по действию методу Prepare. При значении False работает как метод UnPrepare.

(Pb) property StoredProcName: String;

Определяет имя хранимой процедуры на сервере.

 
Обработчики событий

У компонентов TQuery, TTable и TStoredProc полностью совпадают.

Методы компонента

procedure CopyParams(Value: TParams) ;

Копирует всю информацию о параметрах хранимой процедуры в параметр Value.

function DescriptionsAvailable: Boolean;

Возвращает True, если в передаваемых хранимой процедуре параметрах содержится вся необходимая серверу информация. В случае недостатка данных возвращается False.

 
procedure ExecProc;

Выполняет хранимую процедуру. Используется при ожидаемом возвраще­нии одной записи в результате.

procedure GetResults;

Используется только для получения результата выполнения хранимой процедуры сервера SyBase, так как сервер возвращает результат только после достижения курсором последней записи набора данных.

procedure Open;

Выполняет хранимую процедуру. Используется при ожидаемом возвращении группы записей в качестве результата.

procedure Prepare; procedure UnPrepare;

Проводит подготовку выполнения хранимой процедуры на сервере.

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

 
« Предыдущая статья   Следующая статья »