FileSystem.MoveDirectory Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перемещает каталог из одного местоположения в другое.
Перегрузки
MoveDirectory(String, String) |
Перемещает каталог из одного местоположения в другое. |
MoveDirectory(String, String, UIOption) |
Перемещает каталог из одного местоположения в другое. |
MoveDirectory(String, String, Boolean) |
Перемещает каталог из одного местоположения в другое. |
MoveDirectory(String, String, UIOption, UICancelOption) |
Перемещает каталог из одного местоположения в другое. |
MoveDirectory(String, String)
Перемещает каталог из одного местоположения в другое.
public:
static void MoveDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);
public static void MoveDirectory (string sourceDirectoryName, string destinationDirectoryName);
static member MoveDirectory : string * string -> unit
Public Shared Sub MoveDirectory (sourceDirectoryName As String, destinationDirectoryName As String)
Параметры
- sourceDirectoryName
- String
Путь к каталогу, который необходимо переместить.
- destinationDirectoryName
- String
Путь к каталогу, в который необходимо переместить исходный каталог.
Исключения
Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).
sourceDirectoryName
или destinationDirectoryName
равен Nothing
или является пустой строкой.
Каталог не существует.
Источник является корневым каталогом, либо исходный путь совпадает с целевым.
Длина пути превышает максимальную длину, определенную в системе.
Операция является циклической.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Пользователь не имеет необходимого разрешения.
Примеры
В этом примере выполняется перемещение Directory1
внутри Directory2
.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется перезапись Directory1
Directory2
каталога, если он уже существует.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2",
True)
Комментарии
Если предпринята попытка переместить каталог в каталог, который не существует, будет создана целевая структура.
См. также раздел
Применяется к
MoveDirectory(String, String, UIOption)
Перемещает каталог из одного местоположения в другое.
public:
static void MoveDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void MoveDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member MoveDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared Sub MoveDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)
Параметры
- sourceDirectoryName
- String
Путь к каталогу, который необходимо переместить.
- destinationDirectoryName
- String
Путь к каталогу, в который необходимо переместить исходный каталог.
- showUI
- UIOption
Указывает, следует ли отображать ход выполнения операции. Значение по умолчанию — UIOption.OnlyErrorDialogs
.
Исключения
Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).
sourceDirectoryName
или destinationDirectoryName
равен Nothing
или является пустой строкой.
Каталог не существует.
Целевой каталог уже существует, а параметру overwrite
присвоено значение False
.
Длина пути превышает максимальную длину, определенную в системе.
Операция является циклической.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Пользователь не имеет необходимого разрешения.
Примеры
В этом примере выполняется перемещение Directory1
внутри Directory2
.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется перезапись Directory1
Directory2
каталога, если он уже существует.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2",
True)
Комментарии
Если предпринята попытка переместить каталог в каталог, который не существует, будет создана целевая структура.
См. также раздел
Применяется к
MoveDirectory(String, String, Boolean)
Перемещает каталог из одного местоположения в другое.
public:
static void MoveDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);
public static void MoveDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);
static member MoveDirectory : string * string * bool -> unit
Public Shared Sub MoveDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)
Параметры
- sourceDirectoryName
- String
Путь к каталогу, который необходимо переместить.
- destinationDirectoryName
- String
Путь к каталогу, в который необходимо переместить исходный каталог.
- overwrite
- Boolean
Значение True
, если нужно перезаписывать существующие каталоги; в противном случае — значение False
. Значение по умолчанию — False
.
Исключения
Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).
sourceDirectoryName
или destinationDirectoryName
равен Nothing
или является пустой строкой.
Каталог не существует.
Целевой каталог уже существует, а параметру overwrite
присвоено значение False
.
Длина пути превышает максимальную длину, определенную в системе.
Операция является циклической.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Пользователь не имеет необходимого разрешения.
Примеры
Этот пример перемещается Directory1
внутри Directory2
.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется Directory1
Directory2
перезапись каталога, если он уже существует.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2",
True)
Комментарии
Если предпринята попытка переместить каталог в каталог, который не существует, будет создана целевая структура.
См. также раздел
Применяется к
MoveDirectory(String, String, UIOption, UICancelOption)
Перемещает каталог из одного местоположения в другое.
public:
static void MoveDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void MoveDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member MoveDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub MoveDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)
Параметры
- sourceDirectoryName
- String
Путь к каталогу, который необходимо переместить.
- destinationDirectoryName
- String
Путь к каталогу, в который необходимо переместить исходный каталог.
- showUI
- UIOption
Указывает, следует ли отображать ход выполнения операции. Значение по умолчанию — UIOption.OnlyErrorDialogs
.
- onUserCancel
- UICancelOption
Указывает, выдается ли исключение, когда пользователь отменяет операцию. Значение по умолчанию — UICancelOption.ThrowException
.
Исключения
Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).
sourceDirectoryName
или destinationDirectoryName
равен Nothing
или является пустой строкой.
Каталог не существует.
onUserCancel
имеет значение ThrowException
, и подкаталог файла не может быть скопирован.
Параметр onUserCancel
имеет значение ThrowException
, а пользователь отменяет операцию, или операция не может быть завершена.
У пользователя отсутствуют необходимые разрешения на просмотр пути.
Длина пути превышает максимальную длину, определенную в системе.
Операция является циклической.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
Пользователь не имеет необходимого разрешения.
Примеры
Этот пример перемещается Directory1
внутри Directory2
.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется Directory1
Directory2
перезапись каталога, если он уже существует.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2",
True)
Комментарии
Если предпринята попытка переместить каталог в каталог, который не существует, будет создана целевая структура.