|
Метод AddWhere – добавить условие ограничения набора данных |
 
 |
|
Метод AddWhere – добавить условие ограничения набора данных |
|
Синтаксис:
|
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 |
