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 -> unitstatic member Rename : string * string -> unitPublic 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 копирования файла из незащищенного расположения в защищенное расположение файл сохраняет менее ограниченные права. Убедитесь, что вы не представляете возможный риск безопасности.
