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
метод .
Кому | См. |
---|---|
Переименование файла | Практическое руководство. Переименование файла |