Оператор Name

Переименовывает файл, каталог или папку на диске.

Синтаксис

Имяoldpathnameкакnewpathname

Синтаксис оператора Name состоит из следующих частей:

Part	Описание
oldpathname	Обязательно. Строковое выражение , указывающее существующее имя и расположение файла; может включать каталог или папку, а также диск.
newpathname	Обязательно. Строковое выражение, указывающее новое имя и расположение файла; может включать каталог или папку, а также диск. Атрибут newpathname не может задавать имя уже существующего файла.

Замечания

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

Если оператор Name применяется к открытому файлу, возникает ошибка. Прежде чем переименовать открытый файл, необходимо закрыть его. Аргументы name не могут включать подстановочные знаки из нескольких символов (*) и односимвого (?).

Пример

В этом примере показано переименование файла с помощью оператора Name. В этом примере предполагается, что указанные каталоги или папки уже существуют. В Macintosh "HD:" является именем диска по умолчанию, а части pathname разделяются двоеточием, а не обратными косыми чертами.

Dim oldName, newName 
oldName = "OLDFILE": newName = "NEWFILE" ' Define file names. 
Name oldName As newName ' Rename file. 
 
oldName = "C:\MYDIR\OLDFILE": newName = "C:\YOURDIR\NEWFILE" 
Name oldName As newName ' Move and rename file. 

См. также

• Типы данных
• Операторы

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.