Поделиться через


FileSystem.CopyDirectory Метод

Определение

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

Перегрузки

CopyDirectory(String, String)

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

CopyDirectory(String, String, UIOption)

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

CopyDirectory(String, String, Boolean)

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

CopyDirectory(String, String, UIOption, UICancelOption)

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

CopyDirectory(String, String)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

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

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

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.

Исключения

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

destinationDirectoryName или sourceDirectoryName равен Nothing или является пустой строкой.

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

Исходный и конечный пути совпадают.

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

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

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

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

Конечный файл существует, но к нему нет доступа.

Примеры

В следующем примере копируется содержимое каталога TestDirectory1 в TestDirectory2.

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

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

Комментарии

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

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

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

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

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

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

CopyDirectory(String, String, UIOption)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

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

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

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.

showUI
UIOption

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

Исключения

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

destinationDirectoryName или sourceDirectoryName равен Nothing или является пустой строкой.

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

Исходный и конечный пути совпадают.

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

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

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

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

Конечный файл существует, но к нему нет доступа.

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

Примеры

В следующем примере содержимое каталога TestDirectory1 копируется в TestDirectory2, где отображается диалоговое окно хода выполнения и все диалоговые окна ошибок.

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

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

Комментарии

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

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

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

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

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

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

CopyDirectory(String, String, Boolean)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

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

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

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.

overwrite
Boolean

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

Исключения

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

destinationDirectoryName или sourceDirectoryName равен Nothing или является пустой строкой.

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

Исходный и конечный пути совпадают.

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

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

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

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

Конечный файл существует, но к нему нет доступа.

Примеры

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

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

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

Комментарии

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

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

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

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

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

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

CopyDirectory(String, String, UIOption, UICancelOption)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

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

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

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

destinationDirectoryName
String

Местоположение, в которое необходимо скопировать содержимое каталога.

showUI
UIOption

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

onUserCancel
UICancelOption

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

Исключения

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

destinationDirectoryName или sourceDirectoryName равен Nothing или является пустой строкой.

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

Исходный и конечный пути совпадают.

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

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

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

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

Конечный файл существует, но к нему нет доступа.

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

Примеры

В следующем примере содержимое каталога TestDirectory1 копируется в TestDirectory2, отображается диалоговое окно хода выполнения и все диалоговые окна ошибок, и ничего не происходит, если пользователь нажимает кнопку Отмена во время операции.

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

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

Комментарии

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

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

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

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

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

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