FileSystemProxy.CopyDirectory Метод

Определение

Пространство имен:

Microsoft.VisualBasic.MyServices

Сборка:

Microsoft.VisualBasic.Forms.dll

Копирует каталог в другой каталог.

Перегрузки

Имя	Описание
CopyDirectory(String, String)	Копирует каталог в другой каталог.
CopyDirectory(String, String, UIOption)	Копирует каталог в другой каталог.
CopyDirectory(String, String, Boolean)	Копирует каталог в другой каталог.
CopyDirectory(String, String, UIOption, UICancelOption)	Копирует каталог в другой каталог.

CopyDirectory(String, String)

Исходный код:

FileSystemProxy.vb

Копирует каталог в другой каталог.

public:
 void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);

public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName);

member this.CopyDirectory : string * string -> unit

Public Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

Параметры

sourceDirectoryName

String

Каталог, который нужно скопировать.

destinationDirectoryName

String

Расположение, в которое следует скопировать каталог.

Исключения

ArgumentException

Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь к устройству (начинается с \\.\).

ArgumentNullException

destinationDirectoryName sourceDirectoryName или Nothing пустая строка.

DirectoryNotFoundException

Исходный каталог не существует.

IOException

Исходный путь и целевой путь совпадают.

InvalidOperationException

Операция циклическая.

PathTooLongException

Путь превышает заданную системой максимальную длину.

NotSupportedException

Имя папки в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения для просмотра пути.

UnauthorizedAccessException

Целевой файл существует, но не может быть доступ к ней.

Примеры

В следующем примере каталог TestDirectory1 копируется в TestDirectory2файл, перезаписыв существующие файлы.

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

C:\TestDirectory1 Замените C:\TestDirectory2 путь и имя каталога, в который вы хотите скопировать, и расположение, в которое вы хотите скопировать его.

Комментарии

Этот метод копирует содержимое каталога, а также сам каталог. Если целевой каталог не существует, он создается. Если каталог с тем же именем существует в целевом расположении, содержимое двух каталогов объединяются. Во время операции можно указать новое имя каталога.

При копировании файлов в каталог могут возникать исключения, вызванные определенным файлом. При возникновении таких исключений они объединяются в одно исключение, свойство которого Data содержит записи в виде IDictionary , в котором путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении. Используется For…Each для перечисления записей.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyDirectory .

Кому	Смотри
Копирование каталога	Практическое руководство. Копирование каталога в другой каталог

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• How to: Get the Collection of Files in a Directory in a Directory in Visual Basic
• How to: Parse File Paths in Visual Basic

CopyDirectory(String, String, UIOption)

Исходный код:

FileSystemProxy.vb

Копирует каталог в другой каталог.

public:
 void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);

member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

Параметры

sourceDirectoryName

String

Каталог, который нужно скопировать.

destinationDirectoryName

String

Расположение, в которое следует скопировать каталог.

showUI

UIOption

Следует ли визуально отслеживать ход выполнения операции. По умолчанию — UIOption.OnlyErrorDialogs.

Исключения

ArgumentException

Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь к устройству (начинается с \\.\).

ArgumentNullException

destinationDirectoryName sourceDirectoryName или Nothing пустая строка.

DirectoryNotFoundException

Исходный каталог не существует.

IOException

Исходный путь и целевой путь совпадают.

InvalidOperationException

Операция циклическая.

PathTooLongException

Путь превышает заданную системой максимальную длину.

NotSupportedException

Имя папки в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения для просмотра пути.

UnauthorizedAccessException

Целевой файл существует, но не может быть доступ к ней.

OperationCanceledException

ShowUI задано UIOption.AllDialogs значение, и пользователь отменяет операцию или один или несколько файлов в каталоге не могут быть скопированы.

Примеры

В следующем примере каталог TestDirectory1 копируется в TestDirectory2файл, перезаписыв существующие файлы.

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

C:\TestDirectory1 Замените C:\TestDirectory2 путь и имя каталога, в который вы хотите скопировать, и расположение, в которое вы хотите скопировать его.

Комментарии

Этот метод копирует содержимое каталога, а также сам каталог. Если целевой каталог не существует, он создается. Если каталог с тем же именем существует в целевом расположении, содержимое двух каталогов объединяются. Во время операции можно указать новое имя каталога.

При копировании файлов в каталог могут возникать исключения, вызванные определенным файлом. При возникновении таких исключений они объединяются в одно исключение, свойство которого Data содержит записи в виде IDictionary , в котором путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении. Используется For…Each для перечисления записей.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyDirectory .

Кому	Смотри
Копирование каталога	Практическое руководство. Копирование каталога в другой каталог

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• How to: Get the Collection of Files in a Directory in a Directory in Visual Basic
• How to: Parse File Paths in Visual Basic

CopyDirectory(String, String, Boolean)

Исходный код:

FileSystemProxy.vb

Копирует каталог в другой каталог.

public:
 void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);

public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, bool overwrite);

member this.CopyDirectory : string * string * bool -> unit

Public Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

Параметры

sourceDirectoryName

String

Каталог, который нужно скопировать.

destinationDirectoryName

String

Расположение, в которое следует скопировать каталог.

overwrite

Boolean

True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.

Исключения

ArgumentException

Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь к устройству (начинается с \\.\).

ArgumentNullException

destinationDirectoryName sourceDirectoryName или Nothing пустая строка.

DirectoryNotFoundException

Исходный каталог не существует.

IOException

Исходный путь и целевой путь совпадают.

InvalidOperationException

Операция циклическая.

PathTooLongException

Путь превышает заданную системой максимальную длину.

NotSupportedException

Имя папки в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения для просмотра пути.

UnauthorizedAccessException

Целевой файл существует, но не может быть доступ к ней.

Примеры

В следующем примере каталог TestDirectory1 копируется в TestDirectory2файл, перезаписыв существующие файлы.

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

C:\TestDirectory1 Замените C:\TestDirectory2 путь и имя каталога, в который вы хотите скопировать, и расположение, в которое вы хотите скопировать его.

Комментарии

Этот метод копирует содержимое каталога, а также сам каталог. Если целевой каталог не существует, он создается. Если каталог с тем же именем существует в целевом расположении, содержимое двух каталогов объединяются. Во время операции можно указать новое имя каталога.

При копировании файлов в каталоге могут возникать исключения, вызванные определенным файлом, например файлом, существующим во время слияния во время overwriteFalseслияния. При возникновении таких исключений они объединяются в одно исключение, свойство которого Data содержит записи в виде IDictionary , в котором путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении. Используется For…Each для перечисления записей.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyDirectory .

Кому	Смотри
Копирование каталога	Практическое руководство. Копирование каталога в другой каталог

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• How to: Get the Collection of Files in a Directory in a Directory in Visual Basic
• How to: Parse File Paths in Visual Basic

CopyDirectory(String, String, UIOption, UICancelOption)

Исходный код:

FileSystemProxy.vb

Копирует каталог в другой каталог.

public:
 void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void CopyDirectory(string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)

Параметры

sourceDirectoryName

String

Каталог, который нужно скопировать.

destinationDirectoryName

String

Расположение, в которое следует скопировать каталог.

showUI

UIOption

Следует ли визуально отслеживать ход выполнения операции. По умолчанию — UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Указывает, что необходимо сделать, если пользователь нажимает кнопку "Отмена " во время операции. По умолчанию — ThrowException.

Исключения

ArgumentException

Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь к устройству (начинается с \\.\).

ArgumentNullException

destinationDirectoryName sourceDirectoryName или Nothing пустая строка.

DirectoryNotFoundException

Исходный каталог не существует.

IOException

Исходный путь и целевой путь совпадают.

InvalidOperationException

Операция циклическая.

PathTooLongException

Путь превышает заданную системой максимальную длину.

NotSupportedException

Имя папки в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения для просмотра пути.

UnauthorizedAccessException

Целевой файл существует, но не может быть доступ к ней.

OperationCanceledException

ShowUI задано UIOption.AllDialogs значение, и пользователь отменяет операцию или один или несколько файлов в каталоге не могут быть скопированы.

Примеры

В следующем примере каталог TestDirectory1 копируется в TestDirectory2файл, перезаписыв существующие файлы.

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

C:\TestDirectory1 Замените C:\TestDirectory2 путь и имя каталога, в который вы хотите скопировать, и расположение, в которое вы хотите скопировать его.

Комментарии

Этот метод копирует содержимое каталога, а также сам каталог. Если целевой каталог не существует, он создается. Если каталог с тем же именем существует в целевом расположении, содержимое двух каталогов объединяются. Во время операции можно указать новое имя каталога.

При копировании файлов в каталог могут возникать исключения, вызванные определенным файлом. При возникновении таких исключений они объединяются в одно исключение, свойство которого Data содержит записи в виде IDictionary , в котором путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении. Используется For…Each для перечисления записей.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyDirectory .

Кому	Смотри
Копирование каталога	Практическое руководство. Копирование каталога в другой каталог

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• How to: Get the Collection of Files in a Directory in a Directory in Visual Basic
• How to: Parse File Paths in Visual Basic