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

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

Осуществляет переименование файла.

' Usage
My.Computer.FileSystem.RenameFile(file ,newName)
' Declaration
Public Sub RenameFile( _
   ByVal file As String, _
   ByVal newName As String _
)

Параметры

• file
  String. Файл, который необходимо переименовать. Обязательно.

• newName
  String. Новое имя файла. Обязательно.

Исключения

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

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

• Параметр newName содержит информацию о пути или оканчивается обратной косой чертой (\) (ArgumentException).

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

• Параметр newName содержит значение Nothing или пустую строку (ArgumentNullException).

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

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

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

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

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

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

Заметки

Этот метод не может использоваться для перемещения файла; для перемещения и переименования файла используйте Метод My.Computer.FileSystem.MoveFile.

Задачи

В приведенной далее таблице содержатся примеры задач, в которых используется метод My.Computer.FileSystem.RenameFile.

Пример

В этом примере осуществляется изменение имени файла Test.txt на SecondTest.txt.

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Укажите вместо "C:\Test.txt" путь и имя файла, который хотите переименовать.

Требования

Пространство имен:Microsoft.VisualBasic.MyServices

Класс:FileSystemProxy (предоставляет доступ к FileSystem)

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Разрешения

Могут потребоваться следующие разрешения:

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Ссылки

Объект My.Computer.FileSystem

FileSystem.RenameFile

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

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