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

Определение

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

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

FileSystem.vb

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

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

public static void RenameFile(string file, string newName);

static member RenameFile : string * string -> unit

Public Shared 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