<< Щелкните, чтобы показать Содержание >> Разработчику > Объектная модель IS-Builder > Объекты IS-Builder > Базовые объекты > IObject – базовый объект

Метод AddWhere – добавить условие ограничения в запрос набора данных

Contents

Синтаксис:

function AddWhere(

const Condition: WideString): Integer;

Параметры:

Condition – условие ограничения выборки. Условие следует задавать в формате where-условия SQL-запроса:

{(<Условие1>) [and/or/xor (<Условие2>)]}[,...n]

Условие1, Условие2 – простые условия, формируемые по формату:

[not ]<Имя поля> {<Оператор> <Значение>}|{is null}|{like <Значение>}|[between <Значение1> and <Значение2>}|{in ({<Значение>}[,...n])}

где:

•

Имя поля – имя или псевдоним поля набора данных. Если для поля не указан псевдоним и имя поля неуникально то перед именем поля следует указывать имя или псевдоним таблицы в формате <Имя таблицы>.<Имя поля>. В условии можно использовать поля таблиц, указанных в разделе from. Имена и псевдонимы полей и таблиц можно получить с помощью свойств:

•	Псевдоним поля – IRequisite.FieldName;

•	Имя поля – IField.SQLFieldName, IRequisite.SQLFieldName;

•	Псевдоним таблицы – TableName, IDataSet.TableName;

•	Имя таблицы – SQLTableName, IDataSet.SQLTableName;

•	Оператор – один из следующих операторов: =, <, >, <=, >=, <>;

•	Значение – значение соответствующего типа.

Для формирования параметра удобно использовать функцию Format.

Возвращаемое значение:

Идентификатор условия в запросе.

Описание:

Метод добавляет условие в раздел where SQL-запроса набора данных. Добавляемое условие объединяется с уже имеющимися условиями при помощи операции and. Идентификатор условия в запросе следует использовать в качестве параметра метода DelWhere для удаления условия из запроса.

Примечание

При вызове метода не из ISBL-вычислений или из ISBL-вычислений с подключением к системе DIRECTUM, отличной от текущей, значение параметра должно строго соответствовать формату. В противном случае будет сгенерировано исключение.

Пример