Справочник по компонентам Delphi. Часть 3 - Компонент TStoredProc
ОГЛАВЛЕНИЕ
Страница 26 из 44
Компонент TStoredProc
TObject -> TPersistent -> TCornponent -> TDataSet -> TDBDataSet -> TStoredProc
Модуль DBTABLES
Страница Палитры компонентов DataAccess
Позволяет приложению использовать хранимые процедуры сервера базы данных. Хранимые процедуры являются разновидностью метаданных и могут возвращать как единичные записи, так и наборы данных. 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; | Передает серверу сообщение об отказе от использования хранимой процедуры и о необходимости освободить занимаемые ею ресурсы. |