Определяет доступ к диапазону записей таблицы, который устанавливается значениями индексных ключей.

SET KEY TO [eExpression1 | RANGE eExpression2 [, eExpression3]]
   [IN cTableAlias | nWorkArea]

Параметры

eExpression1

Определяет некоторое индексное выражение, в соответствие с которым становятся доступными соответствующие записи таблицы. Выражение eExpression1 - является значение некоторого значения ключа. Все записи, имеющие данное значение индексного ключа, являются доступными.

RANGE eExpression2[, eExpression3]

Если присутствует только первый параметр: eExpression2, то доступными являются записи с индексным ключем, равным или большим указанного выражения. Если указан только второй параметр eExpression3 (вместе с ведущей запятойp), то доступными являются записи, с индексным ключем, равным или меньшим указанного выражения. При наличии обоих параметров: eExpression2 и eExpression3 (перечисленных чере запятую) - доступными являются записи, значение индексного ключа которых равно или больше чем eExpression2, и равно или меньше чем eExpression3.

Например, Таблица CUSTOMER имеет символьное поле с почтовым кодом. Если данная таблица индексирована по данному полю, то можно использовать рассматриваемую команду для указания диапазона индексных значений SET KEY (почтовых индексов).

В следующем примере, в окне Browse, отображаются только записи, для которых почтовый код находится в следующем диапазоне: от "40000" до  "43999":

  CopyCode imageКопировать Код
CLOSE DATABASES
USE customer
SET ORDER TO postalcode
SET KEY TO RANGE '40000', '43999'
BROWSE
IN cTableAlias| nWorkArea

Описывает номер рабочей области или алиас открытой таблицы, для которой определяется диапазон доступности индексного выражения. Параметр cTableAlias определяет алиас таблицы, nWorkArea - определяет номер рабочей области. Если эти параметры не указаны, а опция TO - присутствует, система Visual FoxPro генерирует ошибку, сообщение об ошибке. Если данная опци опускается целиком, команда SET KEY действует в текущей рабочей области, если там открыта таблица с индексом.

Expand imageКомментарии

Команда SET KEY TO ограничивает доступность записей в зависимости от значений текущего индексного ключа (индекса). Рассматриваемая таблица должна быть индексирована, значения указываемых параметров должны соответствовать, по типу, значениям ключевого выражения (индексного выражения).

Использование команды SET KEY TO, без дополнительных параметров, восстанавливает доступ ко всем записям таблицы.

Expand imageСм. также