Команда USE

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

Синтаксис

USE [TableName | SQLViewName | ?]
[IN nWorkArea | cTableAlias]
[AGAIN]
[NOREQUERY [nDataSessionNumber]]
[NODATA]
[INDEX IndexFileList | ?
[ORDER [nIndexNumber | IDXFileName
| [TAG] TagName [OF CDXFileName]
[ASCENDING | DESCENDING]]]]
[ALIAS cTableAlias]
[EXCLUSIVE]
[SHARED]
[NOUPDATE]

Параметры

TableName

Задает имя открываемой таблицы. Поскольку пробелы имеют значение при именова ии файлов в Windows 95 и Windows NT, избегайте использования лишних пробелов в параметре TableName в Visual FoxPro.

SQLViewName

Задает имя открываемого в текущей базе данных представления SQL. Представление SQL создается с помощью команды CREATE SQL VIEW.

?

Открывает диалоговое окно Use, в котором можно выбрать открываемую таблицу.

IN nWorkArea

Задает рабочую область, в которой открывается таблица. Вы можете закрыть таб ицу в конкретной рабочей области, выдав команду USE с предложением IN и номером той рабочей области.

Предложение IN допускает использование числа 0 в качестве номера рабочей об асти. Если задать 0, таблица откроется в свободной рабочей области с наименьшим омером. Например, если таблицы открыты в рабочих областях с номерами с 1 по 10, то следующая команда откроет таблицу customer в рабочей области 11:

USE customer IN 0

IN cTableAlias

Задает, что таблица, открытая в рабочей области, является текущей открытой таб ицей. Псевдоним открытой таблицы назначается с помощью cTableAlias.

Если будут опущены параметры nWorkArea and cTableAlias, то таблица будет открыта в выбранной текущей рабочей области.

AGAIN

Открыть таблицу одновременно в нескольких рабочих областях можно одним из сле ующих методов:

Выберите другую рабочую область и выдайте команду USE с именем таблицы и пред ожением AGAIN.

Выдайте команду USE с именем таблицы и предложением AGAIN, задав другую ра очую область в предложении IN.

Когда таблица открывается повторно в другой рабочей области, она принимает ат ибуты таблицы из оригинальной рабочей области. Например, если таблица была откр та только для чтения или в монопольном режиме, а затем вновь открывается в д угой рабочей области, то в этой новой рабочей области она откроется также только для чтения и в монопольном режиме.

Файлы индексов, открытые для оригинальной таблицы, могут быть использованы повторно открытой таблицей, если вы не открыли для нее свои индексы. В рабочих об астях, в которых таблица открыта повторно, порядок индекса устанавливается равн м 0.

Вы можете открыть индексы, которые не были открыты вместе с оригинальной таб ицей. В этом случае для оригинальной таблицы устанавливается порядок индекса 0.

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

В Visual FoxPro, FoxPro для Windows и FoxPro для MS-DOS при открытии таблицы повторно в другой рабочей области новый дескриптор файла не задействуется.

NOREQUERY [nDataSessionNumber]

Указывает, что данные из удаленного представления SQL не будут загружаться с ова. Опция NOREQUERY допустима только для представлений SQL и обычно испо ьзуется, когда вы вновь открываете представление SQL с помощью предложения AGAIN.

Включение предложения NOREQUERY повышает производительность обработки больших множеств данных, поскольку делает ненужной повторную загрузку данных.

Параметр nDataSessionNumber используется для указания сессии, для которой данные из удаленного представле ия SQL не будут загружаться снова. Если этот параметр опущен, подразумевается текущая сессия.

NODATA

Указывает, что будет загружена только структура представления SQL. Данные пре ставления SQL загружаться не будут.

INDEX IndexFileList

Задает набор индексов, которые необходимо открыть вместе с таблицей. Если таб ица обладает файлом структурного составного индекса, он автоматически откр вается вместе с таблицей.

Список IndexFileList может включать имена файлов простых индексов .IDX и составных индексов .CDX в любых сочетаниях. Расширения имен для файлов индексов задавать не обязательно, если только в этом списке нет файлов .IDX и .CDX с одинаковым именем.

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

INDEX ?

Отображает диалоговое окно Open со списком имеющихся файлов индексов, из кото ого можно выбрать нужные.

ORDER [nIndexNumber]

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

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

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

ORDER [IDXFileName]

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

ORDER [TAG TagName] [OF CDXFileName]

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

ASCENDING

Указывает, что табличные записи предоставляются для доступа и отображаются в возрастающем порядке.

DESCENDING

Указывает, что табличные записи предоставляются для доступа и отображаются в у ывающем порядке.

Опции ASCENDING и DESCENDING не модифицируют файл или тег индекса; они меняют только порядок, в каком записи отображаются и в каком к ним производится доступ.

ALIAS cTableAlias

Создает псевдоним для таблицы. Вы можете употребить его при обращении к таб ице в командах и функциях, требующих или поддерживающих использование псевдонима.

Когда таблица открывается, ей автоматически присваивается псевдоним, представ яющий собой в отсутствие предложения ALIAS просто имя таблицы. Вы можете соз ать другой псевдоним для таблицы, воспользовавшись предложением ALIAS с новым псевдонимом. В Visual FoxPro псевдоним может содержать до 254 букв, цифр и симво ов подчеркивания, причем он должен начинаться с буквы или символа подчеркивания. В других версиях FoxPro псевдоним может состоять не более чем из 10 букв, цифр и символов подчеркивания и должен начинаться с буквы или символа подчеркивания.

Если вы открываете одну таблицу одновременно в нескольких рабочих областях с помощью предложения AGAIN и для этих рабочих областей не указываете псевдоним та лицы, автоматически назначается псевдоним, принимаемый по умолчанию.

Псевдоним, принимаемый по умолчанию, также назначается в случае конфликта. Нап имер:

CLOSE DATABASES

OPEN DATABASE (HOME( ) + 'samples\data\testdata')

ACTIVATE WINDOW View && Open the View Window

USE customer ALIAS orders IN 1 && Alias is ORDERS

USE orders IN 3 && Conflict; alias is C

EXCLUSIVE

Открывает таблицу для монопольного пользования в сети. Подробнее о режиме мо опольного использования таблиц см. описанте команды SET EXCLUSIVE.

SHARED

Открывает таблицу для совместного использования в сети. Опция SHARED позволяет открыть таблицу для совместного использования даже в том случае, когда уста овка EXCLUSIVE имеет значение ON.

NOUPDATE

Запрещает вносить изменения в таблицу и в ее структуру.

Комментарии

Если команда USE выдана без имени таблицы и файл таблицы открыт в выбранной в анный момент рабочей области, таблица закрывается. Кроме того, она закр вается, если в той же рабочей области открывается другая таблица. В одной рабочей об асти одновременно нельзя открыть более одной таблицы.