Поделиться через


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

Определение

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

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

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

Исключения

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

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

-или-

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

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

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

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

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

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

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

Примеры

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

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

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

Комментарии

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

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

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

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

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