FileSystemProxy.RenameFile(String, String) Метод

Определение

Пространство имен:

Microsoft.VisualBasic.MyServices

Сборка:

Microsoft.VisualBasic.Forms.dll

Переименование файла.

public:
 void RenameFile(System::String ^ file, System::String ^ newName);

public void RenameFile (string file, string newName);

member this.RenameFile : string * string -> unit

Public Sub RenameFile (file As String, newName As String)

Параметры

file

String

Файл, который необходимо переименовать.

newName

String

Новое имя файла.

Исключения

ArgumentException

newName содержит сведения о пути или заканчивается обратной косой чертой (\).

ArgumentNullException

file имеет значение Nothing.

-или-

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

FileNotFoundException

Файл не существует.

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

Примеры

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

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

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

Комментарии

Этот метод нельзя использовать для перемещения файла. Для перемещения и переименования файла используется метод MoveFile.

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.RenameFile метод .

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

См. также раздел

• Объекты (Visual Basic)
• Создание, удаление и перемещение файлов и папок в Visual Basic