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

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualBasic
Сборка:
Microsoft.VisualBasic.Core.dll
Сборка:
Microsoft.VisualBasic.dll
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

Переименовывает файл или каталог на диске. Функция 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 не может быть именем существующего файла.

Атрибуты
SupportedOSPlatformAttribute

Исключения

ArgumentException

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

FileNotFoundException

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

IOException

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

Примеры

В этом примере используется 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 копирования файла из незащищенного расположения в защищенное расположение файл сохраняет менее ограниченные права. Убедитесь, что вы не представляете возможный риск безопасности.

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

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