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


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

Определение

Переименовывает файл или каталог на диске. Функция My обеспечивает более высокие показатели производительности и быстродействия в операциях файлового ввода-вывода в сравнении с Rename. Для получения дополнительной информации см. FileSystem.

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);
public static void Rename (string OldPath, string NewPath);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit
static member Rename : string * string -> unit
Public Sub Rename (OldPath As String, NewPath As String)

Параметры

OldPath
String

Обязательный. Строковое выражение, указывающее имя и расположение существующего файла. Выражение OldPath может содержать имя каталога и метку диска для файла.

NewPath
String

Обязательный. Строковое выражение, указывающее имя и расположение нового файла. Параметр NewPath может содержать имя каталога и метку диска для нового местонахождения файла. Имя файла, заданного параметром NewPath не может быть именем существующего файла.

Атрибуты

Исключения

Недопустимый путь.

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

Нельзя переименовать с указанием другого диска.

Примеры

В этом примере используется Rename функция для переименования файла. В этом примере предполагается, что указанные каталоги уже существуют.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

Комментарии

ФункцияRename переименовывает файл и при необходимости перемещает его в другой каталог. Функция Rename может перемещать файл между дисками, но переименовывать существующий каталог можно только в том случае, если NewPath и находятся OldPath на одном диске. Rename Не удается создать новый файл или каталог.

Rename При использовании функции в открытом файле возникает ошибка. Перед переименованием необходимо закрыть открытый файл. Rename Аргументы не могут включать подстановочные знаки из нескольких символов (*) и односимвого (?).

Важно!

При использовании для Rename копирования файла из незащищенного расположения в защищенное расположение файл сохраняет менее ограниченные права. Убедитесь, что вы не представляете возможный риск безопасности.

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

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