Класс TParams
Класс TParams представляет собой список параметров.
Доступ к элементам списка возможен через индексированное свойство
property Items[Index: Word]: TParam;
а к значениям параметров — через свойство
property ParamValues[const ParamName: String]: Variant;
Добавить новый параметр можно методом
procedure AddParam(Value: TParam);
Но для него необходимо создать объект параметра. Это можно сделать методом
function CreateParamfFldType: TFieldType; const ParamName: string; ParamType: TParamType): TParam;
где FidType — тип данных параметра, ParamName — имя параметра и ParamType — тип параметра (см. ниже).
И оба метода можно использовать в связке:
MyParams.AddParam(MyParams.CreateParam(ftInteger, 'Paraml', ptInput));
Вместо того, чтобы заполнять параметры по одному, можно использовать метод
function ParseSQL(SQL: String; DoCreate: Boolean): String;
который при DoCreate = True анализирует текст запроса из свойства SQL и создает новый список параметров.
Или же, для присвоения значений сразу всем параметрам используется метод
procedure AssignValues(Value: TParams);
Для удаления параметра из списка применяется метод
procedure RemoveParam(Value: TParam);
При работе с параметрами для их идентификации полезно использовать обращение по имени, т. к. при работе с хранимыми процедурами после их выполнения порядок следования может измениться. Также и при использовании динамических запросов (их текст SQL может изменяться во время выполнения).
Для обращения к параметру по имени используется метод
function ParamByName(const Value: String): TParam;
В сложных запросах SQL или после многочисленных исправлений разработчик может допустить ошибку и создать два разных параметра с одним именем. В этом случае при выполнении запроса одноименные параметры считаются одним и им присваиваются значение первого по порядку запроса. Для контроля повторных имен в списке параметра используется метод
function IsEqual(Value: TParams): Boolean;
который возвращает значение True, если для параметра value найден дубликат.
