FileSystem.CopyDirectory Метод

Определение

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

Перегрузки

CopyDirectory(String, String)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

CopyDirectory(String, String, UIOption)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

CopyDirectory(String, String, Boolean)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

CopyDirectory(String, String, UIOption, UICancelOption)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

CopyDirectory(String, String)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);
static member CopyDirectory : string * string -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

Параметры

sourceDirectoryName
String

Каталог, который необходимо скопировать.The directory to be copied.

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.The location to which the directory contents should be copied.

Исключения

Путь является недопустимым, так как он либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\).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 \\.\).

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

Исходный каталог не существует.The source directory does not exist.

Исходный и конечный пути совпадают.The source path and target path are the same.

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

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

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

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

Конечный файл существует, но к нему нет доступа.A destination file exists but cannot be accessed.

Примеры

В следующем примере содержимое TestDirectory1 каталога копируется в TestDirectory2.The following example copies the contents of directory TestDirectory1 into TestDirectory2.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2")

Замените C:\TestDirectory1 и C:\TestDirectory2 на путь и имя каталога, который необходимо скопировать, и расположение, куда вы хотите его скопировать.Replace C:\TestDirectory1 and C:\TestDirectory2 with the path and name of the directory you wish to copy and the location to which you wish to copy it.

Комментарии

Этот метод копирует содержимое исходного каталога в целевой каталог.This method copies the contents of the source directory to the target directory. Если целевой каталог не существует, он будет создан.If the target directory does not exist, it is created. Если каталог с таким же именем существует в целевом расположении, содержимое этих двух каталогов объединяется.If a directory with the same name exists in the target location, the contents of the two directories are merged. Во время операции можно указать новое имя для каталога.You can specify a new name for the directory during the operation.

При копировании файлов в каталоге могут возникать исключения, вызванные конкретным файлом.When copying files within a directory, exceptions may be thrown that are caused by a specific file. При возникновении таких исключений они объединяются в одно исключение, свойство Data которого содержит записи в форме IDictionary, в которой путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении.When such exceptions are thrown, they are consolidated into a single exception whose Data property holds entries in the form of an IDictionary in which the file or directory path is the key and the specific exception message is contained in the corresponding value. Для перечисления записей используйте For…Each.Use For…Each to enumerate through the entries.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.CopyDirectory.The following table lists an example of a task involving the My.Computer.FileSystem.CopyDirectory method.

КомуTo См.See
Копирование каталогаCopy a directory Руководство. копирование каталога в другой каталог в Visual BasicHow to: Copy a Directory to Another Directory in Visual Basic

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

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

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

CopyDirectory(String, String, UIOption)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

Параметры

sourceDirectoryName
String

Каталог, который необходимо скопировать.The directory to be copied.

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.The location to which the directory contents should be copied.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.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 \\.\).

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

Исходный каталог не существует.The source directory does not exist.

Исходный и конечный пути совпадают.The source path and target path are the same.

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

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

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

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

Конечный файл существует, но к нему нет доступа.A destination file exists but cannot be accessed.

Параметр ShowUI имеет значение UIOption.AllDialogs, а пользователь отменил операцию, или один или несколько файлов в каталоге не могут быть скопированы.ShowUI is set to UIOption.AllDialogs and the user cancels the operation, or one or more files in the directory cannot be copied.

Примеры

Следующий пример копирует содержимое каталога TestDirectory1 в TestDirectory2, отображая диалоговое окно хода выполнения и любое диалоговое окно ошибки.The following example copies the contents of directory TestDirectory1 into TestDirectory2, showing progress dialog and any error dialog.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs)

Замените C:\TestDirectory1 и C:\TestDirectory2 на путь и имя каталога, который необходимо скопировать, и расположение, куда вы хотите его скопировать.Replace C:\TestDirectory1 and C:\TestDirectory2 with the path and name of the directory you wish to copy and the location to which you wish to copy it.

Комментарии

Этот метод копирует содержимое исходного каталога в целевой каталог.This method copies the contents of the source directory to the target directory. Если целевой каталог не существует, он будет создан.If the target directory does not exist, it is created. Если каталог с таким же именем существует в целевом расположении, содержимое этих двух каталогов объединяется.If a directory with the same name exists in the target location, the contents of the two directories are merged. Во время операции можно указать новое имя для каталога.You can specify a new name for the directory during the operation.

При копировании файлов в каталоге могут возникать исключения, вызванные конкретным файлом.When copying files within a directory, exceptions may be thrown that are caused by a specific file. При возникновении таких исключений они объединяются в одно исключение, свойство Data которого содержит записи в форме IDictionary, в которой путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении.When such exceptions are thrown, they are consolidated into a single exception whose Data property holds entries in the form of an IDictionary in which the file or directory path is the key and the specific exception message is contained in the corresponding value. Для перечисления записей используйте For…Each.Use For…Each to enumerate through the entries.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.CopyDirectory.The following table lists an example of a task involving the My.Computer.FileSystem.CopyDirectory method.

КомуTo См.See
Копирование каталогаCopy a directory Руководство. копирование каталога в другой каталог в Visual BasicHow to: Copy a Directory to Another Directory in Visual Basic

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

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.

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

CopyDirectory(String, String, Boolean)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);
static member CopyDirectory : string * string * bool -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

Параметры

sourceDirectoryName
String

Каталог, который необходимо скопировать.The directory to be copied.

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.The location to which the directory contents should be copied.

overwrite
Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False.True to overwrite existing files; 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 \\.\).

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

Исходный каталог не существует.The source directory does not exist.

Исходный и конечный пути совпадают.The source path and target path are the same.

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

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

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

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

Конечный файл существует, но к нему нет доступа.A destination file exists but cannot be accessed.

Примеры

В следующем примере содержимое TestDirectory1 каталога копируется в TestDirectory2, переписывая существующие файлы.The following example copies the contents of directory TestDirectory1 into TestDirectory2, overwriting existing files.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

Замените C:\TestDirectory1 и C:\TestDirectory2 на путь и имя каталога, который необходимо скопировать, и расположение, куда вы хотите его скопировать.Replace C:\TestDirectory1 and C:\TestDirectory2 with the path and name of the directory you wish to copy and the location to which you wish to copy it.

Комментарии

Этот метод копирует содержимое исходного каталога в целевой каталог.This method copies the contents of the source directory to the target directory. Если целевой каталог не существует, он будет создан.If the target directory does not exist, it is created. Если каталог с таким же именем существует в целевом расположении, содержимое этих двух каталогов объединяется.If a directory with the same name exists in the target location, the contents of the two directories are merged. Во время операции можно указать новое имя для каталога.You can specify a new name for the directory during the operation.

При копировании файлов в каталоге могут возникать исключения, вызванные конкретным файлом, например файлом, существующим во время слияния, в то время как overwrite имеет значение False.When copying files within a directory, exceptions may be thrown that are caused by a specific file, such as a file existing during a merge while overwrite is set to False. При возникновении таких исключений они объединяются в одно исключение, свойство Data которого содержит записи в форме IDictionary, в которой путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении.When such exceptions are thrown, they are consolidated into a single exception whose Data property holds entries in the form of an IDictionary in which the file or directory path is the key and the specific exception message is contained in the corresponding value. Для перечисления записей используйте For…Each.Use For…Each to enumerate through the entries.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.CopyDirectory.The following table lists an example of a task involving the My.Computer.FileSystem.CopyDirectory method.

КомуTo См.See
Копирование каталогаCopy a directory Руководство. копирование каталога в другой каталог в Visual BasicHow to: Copy a Directory to Another Directory in Visual Basic

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

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

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

CopyDirectory(String, String, UIOption, UICancelOption)

Копирует содержимое каталога в другой каталог.Copies the contents of a directory to another directory.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)

Параметры

sourceDirectoryName
String

Каталог, который необходимо скопировать.The directory to be copied.

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.The location to which the directory contents should be copied.

showUI
UIOption

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

onUserCancel
UICancelOption

Определяет, что должно быть выполнено, если во время операции пользователь нажмет кнопку Отмена.Specifies what should be done if the user clicks Cancel during the operation. Значение по умолчанию — ThrowException.Default is 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 \\.\).

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

Исходный каталог не существует.The source directory does not exist.

Исходный и конечный пути совпадают.The source path and target path are the same.

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

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

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

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

Конечный файл существует, но к нему нет доступа.A destination file exists but cannot be accessed.

Параметр ShowUI имеет значение UIOption.AllDialogs, а пользователь отменил операцию, или один или несколько файлов в каталоге не могут быть скопированы.ShowUI is set to UIOption.AllDialogs and the user cancels the operation, or one or more files in the directory cannot be copied.

Примеры

Следующий пример копирует содержимое каталога TestDirectory1 в TestDirectory2, отображая диалоговое окно хода выполнения и любое диалоговое окно ошибки, и не выполняет никаких действий, если пользователь нажимает кнопку Отмена во время операции.The following example copies the contents of directory TestDirectory1 into TestDirectory2, showing progress dialog and any error dialog, and does nothing if the user clicks Cancel during the operation.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)

Замените C:\TestDirectory1 и C:\TestDirectory2 на путь и имя каталога, который необходимо скопировать, и расположение, куда вы хотите его скопировать.Replace C:\TestDirectory1 and C:\TestDirectory2 with the path and name of the directory you wish to copy and the location to which you wish to copy it.

Комментарии

Этот метод копирует содержимое исходного каталога в целевой каталог.This method copies the contents of the source directory to the target directory. Если целевой каталог не существует, он будет создан.If the target directory does not exist, it is created. Если каталог с таким же именем существует в целевом расположении, содержимое этих двух каталогов объединяется.If a directory with the same name exists in the target location, the contents of the two directories are merged. Во время операции можно указать новое имя для каталога.You can specify a new name for the directory during the operation.

При копировании файлов в каталоге могут возникать исключения, вызванные конкретным файлом.When copying files within a directory, exceptions may be thrown that are caused by a specific file. При возникновении таких исключений они объединяются в одно исключение, свойство Data которого содержит записи в форме IDictionary, в которой путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении.When such exceptions are thrown, they are consolidated into a single exception whose Data property holds entries in the form of an IDictionary in which the file or directory path is the key and the specific exception message is contained in the corresponding value. Для перечисления записей используйте For…Each.Use For…Each to enumerate through the entries.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.CopyDirectory.The following table lists an example of a task involving the My.Computer.FileSystem.CopyDirectory method.

КомуTo См.See
Копирование каталогаCopy a directory Руководство. копирование каталога в другой каталог в Visual BasicHow to: Copy a Directory to Another Directory in Visual Basic

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

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.

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

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