Команда SET INDEX

Открывает один или несколько файлов индексов для текущей таблицы.

Синтаксис

SET INDEX TO [IndexFileList | ? ]
[ORDER nIndexNumber | IDXIndexFileName
| [TAG] TagName [OF CDXFileName] [ASCENDING | DESCENDING]]
[ADDITIVE]

Параметры

IndexFileList

Задает один или несколько файлов индексов, которые следует открыть. Имена фай ов индексов в списке разделяйте запятыми. В этот список могут входить имена фай ов индексов .IDX и .CDX в любых сочетаниях; расширение имени файла указывать е обязательно, если нет другого файла .IDX или .CDX с тем же именем.

Первый файл индекса, указанный в списке, становится управляющим файлом ин екса; он управляет процессом доступа к записям и их отображения на экране. Записи отображаются и предоставляются для доступа в физическом порядке их следования, если первым файлом индекса является файл .CDX и команда SET ORDER TO TAG не вы авалась.

?

Отображает диалоговое окно Open, в котором вы можете открыть один файл .IDX.

ORDER nIndexNumber

Задает управляющий файл индекса или тег. Числовое выражение nIndexNumber задает файлы индекса в том порядке, в каком они фигурируют в списке файлов ин ексов. Сначала нумеруются файлы .IDX в порядке их следования в списке файлов и дексов. Теги в файле структурного индекса .CDX (если он существует) нумеруются в порядке их создания. Наконец, нумеруются теги файлов независимых индексов .CDX также в порядке их создания. Подробнее о нумерации файлов и тегов индексов см. SET ORDER.

Если номер nIndexNumber равен 0, записи в таблице отображаются и предоставляются для доступа в физическом порядке их следования, но файлы индексов остаются открытыми. Предложение ORDER 0 позволяет обновлять открытые файлы индексов при доступе к записям в физическом порядке. Предложение ORDER без аргументов идентично предложению ORDER 0.

Если nIndexNumber больше общего числа файлов .IDX и тегов файлов .CDX, Visual FoxPro выдает соо щение об ошибке.

ORDER IDXIndexFileName

Задает файл .IDX в качестве управляющего файла индекса.

ORDER [TAG] TagName [OF CDXFileName]

Задает тег (TagName) файла .CDX в качестве управляющего тега. Имя тега можно взять из файла ст уктурного индекса .CDX или из любого открытого файла независимого индекса .CDX.

Если в открытых файлах независимых индексов .CDX есть теги с одинаковыми име ами, то для задания файла .CDX, содержащего нужный тег, используйте предложение OF CDXFileName.

ASCENDING | DESCENDING

Задает порядок отображения табличных записей и доступа к ним возрастающий или убывающий. В любом случае сами файлы или теги индексов не изменяются; меняется только порядок, в котором записи отображаются или предостав яются для доступа. Ключевое слово ASCENDING или DESCENDING нужно ставить сразу после предложения ORDER.

ADDITIVE

Указывает, что если выдается команда SET INDEX, открывающая дополнительный фай (или файлы) индекса для таблицы, то ранее открытые файлы индексов должны остаться открытыми. Если опция ADDITIVE не задана, ранее открытые файлы, за исключе ием структурного составного индекса, закроются.

Комментарии

Записи таблицы, имеющей один или несколько открытых файлов индексов, могут ото ражаться и предоставляться для доступа в порядке, определенном одним из этих файлов индексов. По команде SET INDEX можно открыть как файлы простых индексов (.IDX), так и файлы составных индексов (.CDX). Если таблица обладает файлом ст уктурного индекса .CDX, он автоматически открывается при открытии самой таблицы.

Только один файл .IDX (управляющий файл индекса) или тег из файла .CDX (контро ирующий тег) определяют порядок отображения записей в таблице и доступа к ним. Некоторые команды (например SEEK) пользуются контролирующим файлом или тегом и декса при поиске записей.

Если выдать команду SET INDEX TO без аргументов, она закроет все открытые файл индексов (за исключением файла структурного индекса .CDX) в текущей рабочей о ласти.