Share via

Практическое руководство. Переименование файла в 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. В средстве выбора фрагментов кода фрагмент находится в разделе файловая система: обработка дисков, папок и файлов. Для получения дополнительной информации см. Code Snippets.

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

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

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

  • newName содержит сведения о пути (ArgumentException).

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

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

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

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

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

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

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

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

См. также