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

Статья
11/05/2008

Обновлен: Ноябрь 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.

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

Пример

В этом примере осуществляется изменение имени файла 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)

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

Тип проекта	Доступно
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Да
Служба Windows	Да
Веб-узел	Да

Разрешения

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

Разрешение	Описание
FileIOPermission	Определяет возможность доступа к файлам и папкам. Связанное перечисление: Unrestricted.