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

Определение

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

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

Параметры

file
String

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

newName
String

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

Исключения

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

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

-или-

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

Каталог не существует.

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

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

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

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

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

Примеры

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

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

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

Комментарии

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

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

Применяется к

Продукт Версии
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1