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

  • Статья

Обновлен: Ноябрь 2007

Чтобы переименовать файл, используется метод 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. В окне выбора фрагмента кода фрагмент находится в разделе Файловая система — Обработка дисков, папок и файлов. Дополнительные сведения см. в разделе Практическое руководство. Вставка фрагментов в код (Visual Basic).

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Задачи

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

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

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

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

Ссылки

Метод My.Computer.FileSystem.RenameFile

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

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