Объекты DIRECTUM

 

Объект IQuery

 

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

Синтаксис:

function AddWhere(

  const Condition: WideString): Integer;

Параметры:

Condition – условие ограничения выборки. Условие следует задавать в формате where-условия SQL-запроса. Имена полей, участвующих в условии, следует задавать в формате [<Имя таблицы>.]<Имя поля>. В условии можно использовать поля таблиц, указанных в разделе from. Имя таблицы и имя поля можно получить с помощью свойств IDataSet.SQLTableName, IObject.SQLTableName, IField.SQLFieldName, IRequisite.SQLFieldName.

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

Если в разделе select указан алиас поля, то условие следует задавать в формате <Алиас поля>. Алиасы полей, используемые в SQL-запросе набора данных, можно получить с помощью свойства IRequisite.FieldName, IField.Name.

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

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

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

Описание:

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

 

 

См. также:

·         метод AddFrom;

·         метод AddSelect;

·         метод DelWhere;

·         свойство IDataSet.SQLTableName;

·         свойство IDataSet.TableName;

·         свойство IField.Name;

·         свойство IField.SQLFieldName;

·         свойство IObject.SQLTableName;

·         свойство IObject.TableName;

·         свойство IRequisite.FieldName;

·         свойство IRequisite.SQLFieldName.