Метод My.Computer.FileSystem.MoveFile

Обновлен: Ноябрь 2007

Перемещает файл в новое место.

' Usage
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Параметры

• sourceFileName
  String. Путь к файлу, который требуется переместить. Обязательный атрибут.

• destinationFileName
  String. Путь к каталогу, в который нужно переместить файл. Обязательный атрибут.

• overwrite
  Boolean. Указывает, следует ли заменить существующие файлы. По умолчанию используется значение False. Обязательный атрибут.

• showUI
  Перечисление UIOption. Указывает, следует ли отображать ход выполнения операции. По умолчанию используется значение UIOption.OnlyErrorDialogs. Обязательный атрибут.

• onUserCancel
  Перечисление UICancelOption. Указывает, создается ли исключение, когда пользователь отменяет операцию. По умолчанию используется значение UICancelOption.ThrowException. Обязательный.

Исключения

Исключение может возникнуть при следующих условиях:

• Путь является недопустимым по одной из следующих причин: строка имеет нулевую длину; строка содержит только пробелы; строка содержит недопустимые знаки; строка является путем устройства (начинается с \\.\) (ArgumentException).

• Имя файла оканчивается косой чертой (\) (ArgumentException).

• Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).

• Параметр destinationFileName равен Nothing или является пустой строкой (ArgumentNullException).

• Исходный файл не является допустимым или не существует (FileNotFoundException).

• Объединенный путь указывает на существующий каталог, файл назначения существует и параметру overwrite присвоено значение False, файл с тем же именем в каталоге назначения уже используется, илиу пользователя нет необходимых разрешений для доступа к файлу (IOException).

• Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).

• onUserCancel имеет значение ThrowException, а пользователь отменил операцию или возникла ошибка ввода-вывода (OperationCanceledException).

• Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).

• У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).

• Пользователь не имеет необходимого разрешения (UnauthorizedAccessException).

Заметки

Если каталог назначения не существует, то он будет создан.

Метод MoveFile сохраняет записи управления доступом (ACE) только при перемещении файла в пределах одного тома. Это включает наследуемые ACE, которые при перемещении становятся прямыми ACE (прямая запись управления доступом имеет приоритет над унаследованными записями управления доступом). Если файл перемещается между томами, то записи управления доступом не копируются.

Задачи

Ниже в таблице приведены примеры задач, в которых используется метод My.Computer.FileSystem.MoveFile.

Пример

Этот пример перемещает файл Test.txt из TestDir1 в TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Этот пример перемещает файл Test.txt из TestDir1 в TestDir2 и переименовывает его в Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Требования

Пространство имен:Microsoft.VisualBasic.MyServices

Класс:FileSystemProxy (предоставляет доступ к FileSystem)

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Разрешения

Могут потребоваться следующие разрешения.

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Ссылки

Объект My.Computer.FileSystem

Перечисление UIOption

Перечисление UICancelOption

Другие ресурсы

Создание, удаление и перемещение файлов и папок в Visual Basic