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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 |
См. также раздел
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по