FileSystem.MoveDirectory Метод

Определение

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

Перегрузки

MoveDirectory(String, String)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

MoveDirectory(String, String, UIOption)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

MoveDirectory(String, String, Boolean)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

MoveDirectory(String, String, UIOption, UICancelOption)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

MoveDirectory(String, String)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

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

Путь к каталогу, который необходимо переместить.Path of the directory to be moved.

destinationDirectoryName
String

Путь к каталогу, в который необходимо переместить исходный каталог.Path of the directory to which the source directory is being moved.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

sourceDirectoryName или destinationDirectoryName равен Nothing или является пустой строкой.sourceDirectoryName or destinationDirectoryName is Nothing or an empty string.

Каталог не существует.The directory does not exist.

Источник является корневым каталогом, либо исходный путь совпадает с целевым.The source is a root directory or The source path and the target path are the same.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Операция является циклической.The operation is cyclic.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

Примеры

В этом примере Directory1 перемещается в Directory2.This example moves Directory1 inside Directory2.

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

Этот пример перемещает Directory1 в Directory2, перезаписывая каталог, если он уже существует.This example moves Directory1 inside Directory2, overwriting the directory if it already exists.

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

Комментарии

При попытке переместить каталог в каталог, который не существует, будет создана целевая структура.If an attempt is made to move a directory inside a directory that does not exist, the target structure will be created.

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

MoveDirectory(String, String, UIOption)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

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

Путь к каталогу, который необходимо переместить.Path of the directory to be moved.

destinationDirectoryName
String

Путь к каталогу, в который необходимо переместить исходный каталог.Path of the directory to which the source directory is being moved.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Specifies whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

sourceDirectoryName или destinationDirectoryName равен Nothing или является пустой строкой.sourceDirectoryName or destinationDirectoryName is Nothing or an empty string.

Каталог не существует.The directory does not exist.

Целевой каталог уже существует, а параметру overwrite присвоено значение False.The target directory already exists and overwrite is set to False.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Операция является циклической.The operation is cyclic.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

Примеры

В этом примере Directory1 перемещается в Directory2.This example moves Directory1 inside Directory2.

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

Этот пример перемещает Directory1 в Directory2, перезаписывая каталог, если он уже существует.This example moves Directory1 inside Directory2, overwriting the directory if it already exists.

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

Комментарии

При попытке переместить каталог в каталог, который не существует, будет создана целевая структура.If an attempt is made to move a directory inside a directory that does not exist, the target structure will be created.

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

MoveDirectory(String, String, Boolean)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

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

Путь к каталогу, который необходимо переместить.Path of the directory to be moved.

destinationDirectoryName
String

Путь к каталогу, в который необходимо переместить исходный каталог.Path of the directory to which the source directory is being moved.

overwrite
Boolean

Значение True, если нужно перезаписывать существующие каталоги; в противном случае — значение False.True if existing directories should be overwritten; otherwise False. Значение по умолчанию — False.Default is False.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

sourceDirectoryName или destinationDirectoryName равен Nothing или является пустой строкой.sourceDirectoryName or destinationDirectoryName is Nothing or an empty string.

Каталог не существует.The directory does not exist.

Целевой каталог уже существует, а параметру overwrite присвоено значение False.The target directory already exists and overwrite is set to False.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Операция является циклической.The operation is cyclic.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

Примеры

В этом примере Directory1 перемещается в Directory2.This example moves Directory1 inside Directory2.

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

Этот пример перемещает Directory1 в Directory2, перезаписывая каталог, если он уже существует.This example moves Directory1 inside Directory2, overwriting the directory if it already exists.

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

Комментарии

При попытке переместить каталог в каталог, который не существует, будет создана целевая структура.If an attempt is made to move a directory inside a directory that does not exist, the target structure will be created.

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

MoveDirectory(String, String, UIOption, UICancelOption)

Перемещает каталог из одного местоположения в другое.Moves a directory from one location to another.

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

Путь к каталогу, который необходимо переместить.Path of the directory to be moved.

destinationDirectoryName
String

Путь к каталогу, в который необходимо переместить исходный каталог.Path of the directory to which the source directory is being moved.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Specifies whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

onUserCancel
UICancelOption

Указывает, выдается ли исключение, когда пользователь отменяет операцию.Specifies whether or not an exception is thrown when the user cancels the operation. Значение по умолчанию — UICancelOption.ThrowException.Default is UICancelOption.ThrowException.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).

sourceDirectoryName или destinationDirectoryName равен Nothing или является пустой строкой.sourceDirectoryName or destinationDirectoryName is Nothing or an empty string.

Каталог не существует.The directory does not exist.

onUserCancel имеет значение ThrowException, и подкаталог файла не может быть скопирован.onUserCancel is set to ThrowException and a subdirectory of the file cannot be copied.

Параметр onUserCancel имеет значение ThrowException, а пользователь отменяет операцию, или операция не может быть завершена.onUserCancel is set to ThrowException, and the user cancels the operation, or the operation cannot be completed.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Операция является циклической.The operation is cyclic.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

Примеры

В этом примере Directory1 перемещается в Directory2.This example moves Directory1 inside Directory2.

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

Этот пример перемещает Directory1 в Directory2, перезаписывая каталог, если он уже существует.This example moves Directory1 inside Directory2, overwriting the directory if it already exists.

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

Комментарии

При попытке переместить каталог в каталог, который не существует, будет создана целевая структура.If an attempt is made to move a directory inside a directory that does not exist, the target structure will be created.

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

Применяется к