Метод 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.

Пример

В этом примере каталог 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)

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

Разрешения

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

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

См. также

Ссылки

Объект My.Computer.FileSystem

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

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

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

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

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

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