Объекты DIRECTUM > Работа с поисками > ISearchCriteria – список критериев поиска >

Свойство AddWhere – дополнительные ограничения в условии поиска

Предыдущий раздел В начало Следующий раздел

Синтаксис:

 rw  property AddWhere: WideString;

Описание:

Свойство предоставляет доступ к дополнительным ограничениям в условии поиска. Свойство следует задавать в формате 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;
· Псевдоним таблицы - IObject.TableName, IDataSet.TableName;
· Имя таблицы - IObject.SQLTableName, IDataSet.SQLTableName;
· Оператор - один из следующих операторов: =, <, >, <=, >=, <>;
· Значение - значение соответсвующего типа.

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

При установке свойства добавляемое условие объединяется с уже имеющимися условиями при помощи операции and.

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

См. также

Свойство AddFrom

Свойство IDataSet.SQLTableName

Свойство IDataSet.TableName

Свойство IObject.SQLTableName

Свойство IObject.TableName

Свойство IRequisite.SQLFieldName