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

APPEND FROM FileName | ?[FIELDS FieldList] [FOR lExpression]
   [[TYPE] [DELIMITED [WITH Delimiter | WITH BLANK | WITH TAB
      | WITH CHARACTER Delimiter] | DIF | FW2 | MOD | PDOX | RPD |
      SDF | SYLK | WK1 | WK3 | WKS | WR1 | WRK | CSV | XLS | XL5 
      [SHEET cSheetName] | XL8 [SHEET cSheetName]]] [AS nCodePage]

Параметры

FileName

Указывает имя файла, из которого добавляются записи. Если вы не включите в имя файла его расширение, то подразумевается таблица Visual FoxPro и ее расширение по умолчанию .dbf. Если вы добавляете записи из таблицы Visual FoxPro, то в случае наличия в таблице, из которой производится добавление записей, записей помеченных для удаления и при текущем установке SET DELETED OFF, то такие записи будут также добавлены в таблицу.

?

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

FIELDS FieldList

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

Замечание
Вы не можете добавить мемо-поля из текстовых файлов, формата CSV и SDF.

FOR lExpression

Добавляет новую запись для каждой записи в текущей выбранной таблице, для которой lExpression оценивается в True (.T.). Записи добавляются до тех пор, пока не будет достигнут конец текущей выбранной таблицы. Если вы опустите в команде ключевое слово FOR, в текущую выбранную таблицу исходный файл будет добавлен целиком.

TYPE

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

Если исходный файл, из которого добавляются записи, не имеет обычного расширения имени файла, используемого по умолчанию ддя данного типа файла, имя исходного файла должно содержать расширение. Например, рабочие листы Microsoft Excel обычно имеют расширение .xls. Если файл Microsoft Excel, из которого добавляются записи, имеет расширение, отличающееся от ожидаемого .xls, убедитесь, что вы указали в командн его существующее расширение.

Замечание
Когда вы добавляете данные из рабочих таблиц Excel, данные в таких таблицах могут храниться в порядке, определяемом строками, а не колонками. Это необходимо учитывать при добавлении данных, что они соответствовали структуре таблицы.

DELIMITED

Указывает, что исходный файл, данные из которого добавляются в текущую таблицу Visual FoxPro представляет собой файл с разделителями. Файл с разделителями представляет собой текст ASCII, в котором каждая запись заканчивается переводом каретки и переносом строки. Содержания полей разделены запятыми, что подразумевается по умолчанию, (не включая лишних пробелов до или после запятых) а значения символьных полей дополнительно разделены кавычками. Например:

	Скопировать код
"Smith",9999999,"TELEPHONE"

Для всех файлов с разделителями в качестве расширения подразумевается .txt.

Вы можете импортировать данные из файлов с разделителями в случае, если даты указаны в соответствующем формате. Для дат форматом по умолчанию установлен mm/dd/yy. Включении части года, указывающей век, не является обязательной. Visual FoxPro будет импортировать дату, такую как 12/25/95, которая не имеет вековой составляющей в позиции чисел года, так как будто дата принадлежит двадцатому веку. Разделителем даты может быть любой нечисленный символ, за исключением разделителя, который разделяет поля в файле с разделителями.

Даты в другом формате могут быть импортированы, если их формат соответствует формату, установленному в SET DATE. Для импорта дат, которые не приведены к формату, используемому по умолчанию, выдайде команду SET DATE с соответствующим форматом даты до использования команды APPEND FROM. Для тестирования - будет дата в используемом формате импортирована или нет используйте для теста CTOD( ). Если дата принимается CTOD( ), и вы имеете точный ожидаемый результат, то даты буду импортированы правильно.

DELIMITED WITH Delimiter

Указывает, что символьные поля разеделены символом, отличным от кавычек.

DELIMITED WITH BLANK

Указывает файлы, которые содержат поля, разделенные пробелами вместо запятых.

DELIMITED WITH TAB

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

DELIMITED WITH CHARACTER Delimiter

Указывает файлы, которые содержат поля, заключенные в символ, указанный в параметре Delimiter. Если Delimiter представляет собой точку с запятой (символ, используемый в Visual FoxPro для указания продления строки команды ), заключите точку с запятой в кавычки. Вы можете, кроме того, указать ключевые слова BLANK и TAB в качестве параметра Delimiter.

Опция WITH Delimiter может быть объединена с опцией WITH CHARACTER. Например, приведенная ниже команда добавляет записи из текстового файла с символьными полями, заключенные в символы подчеркивания и все поля разделены между собой звездочками:

	Скопировать код
APPEND FROM mytxt.txt DELIMITED WITH _ WITH CHARACTER *

DIF

Включите ключевое слово DIF для испорта данных из файлов VisiCalc .dif (Data Interchange Format). Векторы (Vectors) становятся полями в текущей выбранной таблице, а кортежи (tuples) становятся записями. Подразумевается, что файлы DIF имеют расширение .dif.

FW2

Включите ключевое слово FW2 для испорта данных из файлов, созданных Framework II. Подразумевается, что файлы FW2 имеют расширение .fw2.

MOD

Включите ключевое слово MOD для испорта данных из файлов Microsoft Multiplan версии 4.01 . Подразумевается, что файлы MOD имеют расширение .mod.

PDOX

Включите ключевое слово PDOX для испорта данных из файлов Paradox версии 3.5 или 4.0 . Подразумевается, что файлы Paradox имеют расширение .db.

RPD

Включите ключевое слово RPD для испорта данных из файлов, созданных RapidFile version 1.2.Подразумевается, что файлы RapidFile имеют расширение .rpd .

SDF

Включите ключевое слово SDF для импортирования данных из файлов формата System Data Format. Файл SDF представляет собой текстовый ASCII файл, в котором записи имеют фиксированную длину и заканчиваются переводом каретки и переносом строки. Поля не разеделены. В качестве расширения имени файла подразумевается .txt для всех SDF файлов.

Эффективное преобразование даты из файлов SDF в таблицы Visual FoxPro требует, чтобы дата хранилась в формате YYYYMMDD.

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

SYLK

Включите ключевое слово SYLK для импортирования данных из файлов SYLK (Symbolic Link) interchange format. Файлы SYLK используются в Microsoft MultiPlan. Колонки в файле SYLK становятся полями в таблице Visual FoxPro, а строки - записями. Имена файлов SYLK не имеют расширения.

WK1

Включите ключевое слово WK1 для импортирования данных из файлов таблиц Lotus 1-2-3 ревизии 2.x. Каждая колонка таблицы Lotus становится полем в таблице Visual FoxPro, а каждая строка - записью. Расширение имени файла .WK1 присваивается таблицам, созданным в Lotus 1-2-3 ревизии 2.x.

WK3

Включите ключевое слово WK3 для импортирования данных из файлов таблиц Lotus 1-2-3. Каждая колонка в таблице Lotus становится полем в таблице Visual FoxPro; каждая строка - записью. Расширение имени файла .wk3 присваивается таблицам, созданным в Lotus 1-2-3 ревизии 3.x.

WKS

Включите ключевое слово WKS для импорта данных из Lotus 1-2-3 ревизии 1-A Каждая колонка в таблице Lotus становится полем в таблице Visual FoxPro; каждая строка - записью. Расширение имени файла .wks присваивается таблицам, созданным в Lotus 1-2-3 ревизии 1-A.

WR1

Включите ключевое слово WR1 для импорта данных из Lotus Symphony версии 1.1 or 1.2 . Каждая колонка в таблице Lotus становится полем в таблице Visual FoxPro; каждая строка - записью. Расширение имени файла .wr1 присваивается таблицам, созданным в Lotus Symphony версии 1.1 или 1.2.

WRK

Включите ключевое слово WRK для импорта данных из Lotus Symphony версии 1.0 Каждая колонка в таблице Lotus становится полем в таблице Visual FoxPro; каждая строка - записью. Расширение имени файла .wrk присваивается таблицам, созданным в Lotus Symphony версии 1.0.

CSV

Включите ключевое слово CSV для импорта данных из файла со значениями, разделенными запятами. Файла CSV имеет в первой строке перечисление имен полей; эта строка игнорируется при импорте файла.

XLS

Включите ключевое слово XLS для импорта данных из Microsoft Excel worksheet. Каждая колонка становится полем в таблице, а каждая строка рабочего листа - записью. Файлы рабочих листо, созданные в Microsoft Excel имеют в имени файла расширение .xls.

XL5

Включите ключевое слово XL5 для импорта данных из Microsoft Excel версии 5.0. Колонки из рабочего листа становятся полями таблицы, а строки - записями. Рабочие листы, созданыые в Microsoft Excel имеют расширение имени файла .xls.

Если вы опустите опцию SHEET, то импортируются данные из Sheet1. Для импорта данных из конкретного листа, включите в команду ключевое слово SHEET и укажите имя листа в cSheetName.

XL8

Включите ключевое слово XL8 для импорта данных из Microsoft Excel 97. Колонки из рабочего листа становятся полями таблицы, а строки - записями. Файлы рабочих таблиц, созданные в Microsoft Excel имеют расширение .xls.

Если вы опустите опцию SHEET, то импортируются данные из Sheet1. Для импорта данных из конкретного листа, включите в команду ключевое слово SHEET и укажите имя листа в cSheetName.

AS nCodePage

Указывает кодовую страницу исходной таблицы или файла. Visual FoxPro копирует содержимое исходной таблицы или файла и, при копировании данных, автоматически преобразует данные в кодовую страницу текущей таблицы.

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

Если вы опустите AS nCodePage, а Visual FoxPro не сможет определить кодовую страницу исходной таблицы или файла, то Visual FoxPro просто скопирует содержимое исходной таблицы или файла. При копировании, он автоматически преобразует данные в текущую кодовую страницу. Если SET CPDIALOG установлен в ON, таблица в текущей выбранной рабочей области маркируется кодовой страницей. Если вы добавляете данные из таблицы, которая не маркирована кодовой страницей, то будет отображено диалоговое окно Кодовая страница (Code Page), что даст вам возможность выбрать кодовую страницу таблицы, из которой добавляются данные. Текущая кодовая страница Visual FoxPro может быть определена с помощью функции CPCURRENT().

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

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

Примечания

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

До того, как вы сможете добавить данные из таблиц, созданных в dBASE IV или dBASE V, которые содержат мемо-поля, вы сначала должны открыть таблицу в Visual FoxPro с помощью команды USE. Когда вы будете запрошены о преобразовании файла, выберите Yes.

Если вы добавляете данные из таблицы Visual FoxPro или таблицы, созданной в ранних версиях FoxPro, таблица, из которой вы добавляете данные должна быть открыта в свободной рабочей области.

Используйте функцию DBF( ) для добавления данных из временных курсоров, имеющих атрибут "только для чтения", созданных командой SELECT - SQL. Включите имя курсора в функцию DBF( ) так, как показано в приведенном ниже примере:

	Скопировать код
APPEND FROM DBF('<Cursor Name>')

Если целевая таблица, то есть таблица, в которую добавляются записи использует автоувеличение значений поля, APPEND FROM не сработает, если AUTOINCERROR установлено в ON, если опция FIELDS не используется для пропуска полей с AUTOINC. Установка AUTOINCERROR в OFF или выключение автоувеличения целевой таблицы с помощью функции CURSORSETPROP( ) позволяет провести добавление записей с помощью APPEND FROM. Поля автоувеличения целевой таблицы или поля, значения которых увеличиваются в соответствии с указанными значениями, а также значения в исходной таблице не используются.

Пример

В приведенном ниже примере таблица customer открыта, ее структура копируется в таблицу с названием backup, и эта таблица - backup также открывается. Затем Visual FoxPro добавляет все записи, для которых значение поля равно Finland, из таблицы customer. Эти записи затем копируются в новый, разделенный запятыми файл с именем TEMP.TXT.

	Скопировать код
CLOSE DATABASES OPEN DATABASE (HOME(2) + 'Data\testdata') USE customer && Open customer table COPY STRUCTURE TO backup USE backup APPEND FROM customer FOR country = 'Finland' COPY TO temp TYPE DELIMITED MODIFY FILE temp.txt USE DELETE FILE backup.dbf DELETE FILE temp.txt

Смотрите также