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


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

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

Перемещает каталог из одного расположения в другое.

' Usage
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)

' Declaration
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Параметры

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

  • destinationDirectoryName
    String. Путь к каталогу, в который перемещается исходный каталог. Обязательный компонент.

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

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

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

Исключения

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

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

  • Путь равен Nothing (ArgumentNullException).

  • Исходный каталог является недопустимым (DirectoryNotFoundException).

  • Исходный каталог является корневым каталогом (IOException).

  • Объединенный путь указывает на существующий файл (IOException).

  • Исходный и конечный пути совпадают (IOException).

  • Файл уже существует, а параметру overwrite присвоено значение False (IOException).

  • onUserCancel имеет значение ThrowException и подкаталоги файла не могут быть скопированы (IOException).

  • Операция является циклической (InvalidOperationException).

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

  • Параметр UICancelOption имеет значение ThrowException, а пользователь отменяет операцию, или операция не может быть завершена (OperationCanceledException).

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

  • Параметру UICancelOption присвоено значение ThrowException, при этом пользователь не имеет необходимых разрешений (SecurityException).

  • Пользователь не имеет разрешений на изменение файла (UnauthorizedAccessException).

Заметки

Если предпринимается попытка переместить каталог внутрь несуществующего каталога, то будет создана структура целевого каталога.

Задачи

В следующей таблице содержатся примеры задач с использованием метода My.Computer.FileSystem.MoveDirectory.

To

См. разделы

Перемещение каталога

Практическое руководство. Перемещение каталога в Visual Basic

Пример

В этом примере каталог Directory1 перемещается внутрь каталога Directory2.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

В этом примере каталог Directory1 перемещается внутрь каталога Directory2, при этом выполняется перезапись каталога, если каталог с таким именем уже существует.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

Требования

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

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

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

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

Тип проекта

Доступность

Приложение Windows

Да

Библиотека классов

Да

Консольное приложение

Да

Библиотека элементов управления Windows

Да

Библиотека веб-элементов управления

Да

Служба Windows

Да

Веб-узел

Да

Разрешения

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

Разрешение

Описание

FileIOPermission

Управляет доступом к файлам и папкам. Связанное перечисление: Unrestricted.

UIPermission

Определяет разрешения, относящиеся к пользовательским интерфейсам и буферу обмена. Связанное перечисление: SafeSubWindows.

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

См. также

Ссылки

Объект My.Computer.FileSystem

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

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

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

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

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

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