Команда EXPORT

Копирует данные из таблицы Visual FoxPro в файл другого формата.

Синтаксис

EXPORT TO FileName
[TYPE] DIF | MOD | SYLK | WK1 | WKS | WR1 | WRK | XLS | XL5
[FIELDS FieldList]
[Scope]
[FOR lExpression1]
[WHILE lExpression2]
[NOOPTIMIZE]
[AS nCodePage]

Параметры

FileName

Задает имя файла, в который Visual FoxPro экспортирует данные. Если имя файла указано без расширения, ему назначается расширение, используемое по умолчанию д я заданного типа файлов.

FIELDS FieldList

Задает поля, которые будут копироваться в новый файл. Если предложение FIELDS опущено, в новый файл копируются все поля. Memo-поля и поля типа General не копируются, даже если их имена включены в список полей.

Scope

Задает диапазон записей, которые следует скопировать в новый файл. Копированию подлежат только записи, попадающие в указанный диапазон. Он задается сле ующими предложениями: ALL, NEXT nRecords, RECORD nRecordNumber и REST. Подробнее о предложениях диапазона см. тему Предложения диапазона или главу 2 "Обзор языка программирования" Руководства разработчика. Команды, использующие предложение Scope, воздействуют только на таблицу в активной рабочей области.

По умолчанию областью действия команды EXPORT являются все записи.

FOR lExpression1

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

Технология Rushmore оптимизирует команду EXPORT ... FOR lExpression1, если lExpression1 является оптимизируемым выражением. Для достижения наилучшей производитель ости используйте в предложении FOR оптимизируемое выражение. Подробнее об этом см. темы SET OPTIMIZE и Основы технологии Rushmore и главу 17 " Оптимизация приложений" Руководства разработчика.

WHILE lExpression2

Задает условие, в соответствии с которым записи копируются в новый файл до тех пор, пока логическое выражение lExpression2 остается истинным (.T.).

NOOPTIMIZE

Блокирует оптимизацию команды EXPORT по технологии Rushmore. Подробнее см. тем SET OPTIMIZE и Основы технологии Rushmore и главу 17 " Оптимизация приложений" Руководства разработчика.

TYPE

Задает тип файла, который предстоит создать. Само ключевое слово TYPE нео язательно, но тип файла указать необходимо; ниже перечислены возможные значения.

Тип файла	Описание
DIF	Если задать DIF, каждое поле из таблицы Visual FoxPro становится вектором (сто бцом) файла формата DIF (Data Interchange Format), используемого в VisiCalc, а каждая запись таблицы становится кортежем (строкой) этого файла. Имя нового файла получает расширение .DIF, если в составе FileName не задано иное расширение.
MOD	Используйте предложение MOD для экспортирования в файл формата MOD для Microsoft Multiplan версии 4.01. Имя нового файла получает расширение .MOD, если в составе FileName не задано иное расширение.
SYLK	Файл формата обмена SYLK (Symbolic Link) используется в Microsoft Multiplan; в этом файле каждое поле из таблицы Visual FoxPro становится столбцом электрон ой таблицы, а каждая запись становится строкой. По умолчанию имена файлов SYLK е имеют расширения.
WK1	Данная опция применяется для создания электронной таблицы Lotus 1-2-3 из таб ицы Visual FoxPro. Имя файла электронной таблицы, используемого в Lotus 1-2-3 ре акции 2.x, получает расширение .WK1. Каждое поле таблицы Visual FoxPro ста овится столбцом в новой электронной таблице, а каждая запись становится строкой.
WKS	С помощью этой опции из таблицы Visual FoxPro можно создать электронную таб ицу Lotus 1-2-3. Имя файла электронной таблицы, используемого в Lotus 1-2-3 ре акции 1-A, получает расширение .WKS. Каждое поле таблицы Visual FoxPro становится столбцом в новой электронной таблице, а каждая запись становится строкой.
WR1	Используйте эту опцию для создания электронной таблицы Lotus Symphony из таб ицы Visual FoxPro. Имя электронной таблицы, используемой в Symphony версии 1.01, получает расширение .WR1. Каждое поле таблицы Visual FoxPro становится стол цом в новой электронной таблице, а каждая запись становится строкой.
WRK	С помощью этой опции из таблицы Visual FoxPro можно создать электронную таб ицу Lotus Symphony. Имя электронной таблицы, используемой в Symphony версии 1.10, получает расширение .WRK. Каждое поле таблицы Visual FoxPro становится стол цом в новой электронной таблице, а каждая запись становится строкой.
XLS	Включите опцию XLS для создания электронной таблицы, которую можно испо ьзовать в Microsoft Excel. Каждое поле в выбранной таблице становится столбцом элект онной таблицы, а каждая запись становится строкой. Вновь созданному файлу элект онной таблицы назначается расширение имени .XLS, если вы не задали иное расши ение.
XL5	Включите опцию XL5 для создания файла электронной таблицы Microsoft Excel 5.0. Каждое поле выбранной в данный момент таблицы становится столбцом электронной таблицы, а каждая запись становится строкой. Вновь созданной электронной таб ице назначается расширение имени .XLS, если вы не задали иное расширение.

AS nCodePage

Задает кодовую страницу для файла, создаваемого командой EXPORT. Visual FoxPro копирует содержимое выбранной в данный момент таблицы и в процессе копирования данных автоматически преобразует их в кодовую страницу, указанную для нового файла. Visual FoxPro помечает вновь созданный файл, если это возможно, заданной кодовой страницей.

Если заданная кодовая страница nCodePage не поддерживается, Visual FoxPro генерирует сообщение об ошибке. Выдав фу кцию GETCP( ) для кодовой страницы nCodePage, можно отобразить диалоговое окно Code Page и в нем задать кодовую страницу д я создаваемого файла.

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

Если значение nCodePage равно 0, преобразование кодовой страницы не производится и вновь созданный файл не помечается кодовой страницей.

Комментарии

Используйте команду EXPORT для работы с данными Visual FoxPro в других прог аммных продуктах.

Если таблица, из которой производится экспортирование, индексирована, то новый файл создается в порядке индексирования.