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 Аргументы не могут включать подстановочные знаки с несколькими символами (*) и однозначными знаками (?).
Important
При использовании Rename для копирования файла из незащищенного расположения в защищенное расположение файл сохраняет менее ограниченные права. Убедитесь, что вы не вводите возможный риск безопасности.
