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

Статья
11/05/2008

Обновлен: Ноябрь 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.