Изменяет имя файла на новое имя.

Note
Не используйте RENAME для изменения имени таблицы в базе данных; RENAME не изменяет имени таблицы в базе данных. Используйте RENAME TABLE для изменения имени таблицы в базе данных. Для получения дополнительной информации, смотрите Команда RENAME TABLE.

Note

Не используйте RENAME для изменения имени таблицы в базе данных; RENAME не изменяет имени таблицы в базе данных. Используйте RENAME TABLE для изменения имени таблицы в базе данных. Для получения дополнительной информации, смотрите Команда RENAME TABLE.


RENAME FileName1 TO FileName2

Параметры

FileName1 TO FileName2

Определяет имя файла для изменения и новое имя файла. Включите расширение файла для каждого файла.

Note
Если невключены расширения файлов, принимается расширение по умолчанию .dbf. Чтобы переименовывать файл, который не имеет расширения, включите период (.) после имени файла. Если вы переименовываете свободную таблицу, которая имеет связанный .fpt мемо файл, убедитесь, что переименовали и мемо файл.

Note

Если невключены расширения файлов, принимается расширение по умолчанию .dbf. Чтобы переименовывать файл, который не имеет расширения, включите период (.) после имени файла. Если вы переименовываете свободную таблицу, которая имеет связанный .fpt мемо файл, убедитесь, что переименовали и мемо файл.

Замечания

FileName1 и FileName2 могут содержать групповые символы такие как * и ?. Например, чтобы переименовать все файлы програм с расширением .prg в текущем каталоге или папке в файлы резервной копии с расширением .bak, выдайте команду RENAME *.prg TO *.bak.

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

Если FileName1 и FileName2 находятся в различных каталогах или папках, FileName1 перемещается в каталог или папку FileName2.

Когда вы відаете RENAME, FileName2 не может уже существовать и FileName1 должен существовать и не должен быть открытым.

Пример

Следующий пример показывает, как переключить имена файла между двумя файлами. Visual FoxPro сгенерирует ошибку, если вы попытаетесь переименовать файл в имя, которое уже существует (это демонстрируется выражением Try…Catch). Пример использует многократный вызов RENAME с дополнительным временным файлом, для достижения переключения имен.

	Copy Code
STRTOFILE("File 1", "tmpFile1.txt") STRTOFILE("File 2", "tmpFile2.txt") TRY RENAME tmpFile1.txt TO tmpFile2.txt CATCH TO oError ? oError.Message ENDTRY RENAME tmpFile2.txt TO tmpFile2.bkup RENAME tmpFile1.txt TO tmpFile2.txt RENAME tmpFile2.bkup TO tmpFile1.txt MODIFY FILE tmpFile1.txt NOWAIT MODIFY FILE tmpFile2.txt NOWAIT

Copy Code

STRTOFILE("File 1", "tmpFile1.txt")
STRTOFILE("File 2", "tmpFile2.txt")
TRY
RENAME tmpFile1.txt TO tmpFile2.txt
CATCH TO oError
? oError.Message
ENDTRY
RENAME tmpFile2.txt TO tmpFile2.bkup
RENAME tmpFile1.txt TO tmpFile2.txt
RENAME tmpFile2.bkup TO tmpFile1.txt
MODIFY FILE tmpFile1.txt NOWAIT
MODIFY FILE tmpFile2.txt NOWAIT

Параметры

Замечания

Пример

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

Справочное руководство

Прочие ресурсы