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
Nothing или destinationDirectoryName пустая строка.
Каталог не существует.
Источником является корневой каталог или исходный путь, а целевой путь совпадает.
Путь превышает заданную системой максимальную длину.
Операция циклическая.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
У пользователя нет необходимых разрешений.
Примеры
Этот пример перемещается Directory1 внутри Directory2.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется Directory1Directory2перезапись каталога, если он уже существует.
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
Nothing или destinationDirectoryName пустая строка.
Каталог не существует.
Целевой каталог уже существует и overwrite имеет значение False.
Путь превышает заданную системой максимальную длину.
Операция циклическая.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
У пользователя нет необходимых разрешений.
Примеры
Этот пример перемещается Directory1 внутри Directory2.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется Directory1Directory2перезапись каталога, если он уже существует.
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
Nothing или destinationDirectoryName пустая строка.
Каталог не существует.
Целевой каталог уже существует и overwrite имеет значение False.
Путь превышает заданную системой максимальную длину.
Операция циклическая.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
У пользователя нет необходимых разрешений.
Примеры
Этот пример перемещается Directory1 внутри Directory2.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется Directory1Directory2перезапись каталога, если он уже существует.
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
Nothing или destinationDirectoryName пустая строка.
Каталог не существует.
onUserCancel задано значение ThrowException и не удается скопировать подкаталог файла.
onUserCancel задано значение ThrowException, и пользователь отменяет операцию или операцию не может быть завершена.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
Путь превышает заданную системой максимальную длину.
Операция циклическая.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя нет необходимых разрешений.
Примеры
Этот пример перемещается Directory1 внутри Directory2.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")
В этом примере выполняется Directory1Directory2перезапись каталога, если он уже существует.
My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2",
True)
Комментарии
Если предпринята попытка переместить каталог в каталог, который не существует, будет создана целевая структура.