Метод 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; |
| • | Псевдоним таблицы - IObject.TableName, IDataSet.TableName; |
| • | Имя таблицы - IObject.SQLTableName, IDataSet.SQLTableName; |
| • | Оператор - один из следующих операторов: =, <, >, <=, >=, <>; |
| • | Значение - значение соответствующего типа. |
Для формирования параметра удобно использовать функцию Format.
Возвращаемое значение:
Идентификатор условия в запросе.
Описание:
Метод добавляет условие в раздел where SQL-запроса. Если раздел where еще не был определен, то он создается. Если раздел where уже был определен, то добавляемое условие объединяется с уже имеющимися условиями при помощи операции «and». Идентификатор условия в запросе следует использовать в качестве параметра метода DelWhere для удаления условия из запроса.
Примечание
При вызове метода не из ISBL-вычислений или из ISBL-вычислений с подключением к системе DIRECTUM, отличной от текущей, значение параметра должно строго соответствовать формату. В противном случае будет сгенерировано исключение.
Метод AddFrom Метод AddSelect Метод DelWhere Свойство IDataSet.SQLTableName Свойство IDataSet.TableName Свойство IField.Name Свойство IField.SQLFieldName Свойство IObject.SQLTableName Свойство IObject.TableName Свойство IRequisite.FieldName Свойство IRequisite.SQLFieldName |
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |