Поделиться через


Практическое руководство. Переименование файла в Visual Basic

Чтобы переименовать файл, используется метод RenameFile объекта My.Computer.FileSystem, указав текущее расположение, имя файла и новое имя файла. Этот метод нельзя использовать для перемещения файла; для перемещения файла используйте метод MoveFile.

Чтобы переименовать файл

  • Для переименования файла используйте метод My.Computer.FileSystem.RenameFile. В этом примере выполняется переименование файла с именем Test.txt на SecondTest.txt.

    ' Change "c:\test.txt" to the path and filename for the file that
    ' you want to rename.
    My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
    

Данный пример кода доступен также в качестве фрагмента кода IntelliSense. В окне выбора фрагмента кода фрагмент находится в разделе Файловая система — Обработка дисков, папок и файлов. Дополнительные сведения см. в разделе Практическое руководство. Вставка фрагментов кода IntelliSense.

Отказоустойчивость

Исключение может возникнуть при следующих условиях.

  • Путь является недопустимым по одной из следующих причин: Он является строкой нулевой длины, содержит только пробелы, содержит недопустимые символы, или это путь устройства (начинается с \\. \) (ArgumentException).

  • newName содержит информацию о пути (ArgumentException).

  • Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).

  • Параметр newName равен Nothing или является пустой строкой (ArgumentNullException).

  • Исходный файл не является допустимым или не существует (FileNotFoundException).

  • Имеется существующий файл или каталог с именем, указанным в newName (IOException).

  • Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).

  • Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).

  • У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).

  • Пользователь не имеет необходимого разрешения (UnauthorizedAccessException).

См. также

Задачи

Практическое руководство. Перемещение файла в Visual Basic

Практическое руководство. Перемещение набора файлов в Visual Basic

Практическое руководство. Создание копии файла в том же каталоге в Visual Basic

Практическое руководство. Создание копии файла в другом каталоге в Visual Basic

Ссылки

RenameFile

Другие ресурсы

Создание, удаление и перемещение файлов и папок в Visual Basic