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

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

  • Статья

В Visual Basic существует два способа переименовать файл. Для переименования файла можно использовать объект My.Computer.FileSystem времени выполнения Visual Basic или предоставленный System.IO.File объект .NET.

Переименование с помощью .NET

Объект System.IO.File не содержит метода для переименования файла, вместо этого используйте Move метод для перемещения файла в то же расположение, но с другим именем файла. Этот метод также можно использовать для перемещения файла в другое расположение с другим именем, выполняя перемещение и переименование вместе.

В следующем примере файл, расположенный в папке My Documents , переименовывается в TextFile.txtNewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePathSource = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
Dim filePathTarget = System.IO.Path.Combine(myDocsFolder, "NewName.txt")

System.IO.File.Move(filePathSource, filePathTarget)

Переименование с помощью времени выполнения Visual Basic

RenameFile Используйте метод My.Computer.FileSystem объекта для переименования файла, указав полный путь к файлу и новому имени файла. Этот метод нельзя использовать для перемещения файла в другой каталог. Сведения о перемещении файла см. в статье "Практическое руководство. Перемещение файла в Visual Basic".

В следующем примере файл, расположенный в папке My Documents , переименовывается в TextFile.txtNewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePath = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")

My.Computer.FileSystem.RenameFile(filePath, "NewName.txt")

Visual Studio предоставляет фрагмент кода IntelliSense, который использует My.Computer.FileSystem.RenameFile. Фрагмент кода находится в файловой системе — обработка дисков, папок и файлов. Для получения дополнительной информации см. Code Snippets.

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

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

  • Путь недействителен по одной из следующих причин: это строка нулевой длины, она содержит только пробелы, содержит недопустимые символы, или это путь устройства (начинается с \\.\).\) (ArgumentException).
  • newName содержит сведения о пути (ArgumentException).
  • Путь недействителен, так как это Nothing (ArgumentNullException).
  • ПараметрnewName имеет значение Nothing или является пустой строкой (ArgumentNullException).
  • Исходный файл недействителен или не существует (FileNotFoundException).
  • Существует существующий файл или каталог с именем, указанным в newName (IOException).
  • Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).
  • Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).
  • У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).
  • У пользователя нет необходимых разрешений (UnauthorizedAccessException).

См. также