FileSystemProxy.CopyDirectory Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Копирует каталог в другой каталог.
Перегрузки
| CopyDirectory(String, String) |
Копирует каталог в другой каталог. |
| CopyDirectory(String, String, UIOption) |
Копирует каталог в другой каталог. |
| CopyDirectory(String, String, Boolean) |
Копирует каталог в другой каталог. |
| CopyDirectory(String, String, UIOption, UICancelOption) |
Копирует каталог в другой каталог. |
CopyDirectory(String, String)
Копирует каталог в другой каталог.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);member this.CopyDirectory : string * string -> unitPublic 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", True)
Замените C:\TestDirectory1 и C:\TestDirectory2 путем и именем каталога, в который вы хотите скопировать, а также расположением, в которое вы хотите скопировать его.
Комментарии
Этот метод копирует и содержимое каталога, и сам каталог. Если целевой каталог не существует, он создается. Если каталог с таким же именем существует в целевом расположении, содержимое двух каталогов объединяется. Во время операции можно указать новое имя для каталога.
При копировании файлов в каталоге могут возникать исключения, вызванные определенным файлом. При возникновении таких исключений они объединяются в одно исключение, свойство которого Data содержит записи в виде IDictionary , в котором путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении. Используйте For…Each для перечисления по записям.
В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyDirectory .
| Кому | См. |
|---|---|
| Копирование каталога | Практическое руководство. Копирование каталога в другой каталог |
См. также раздел
- UICancelOption
- Объекты (Visual Basic)
- Практическое руководство. Получение коллекции содержащихся в каталоге файлов в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
CopyDirectory(String, String, UIOption)
Копирует каталог в другой каталог.
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 -> unitPublic 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", True)
Замените C:\TestDirectory1 и C:\TestDirectory2 путем и именем каталога, в который вы хотите скопировать, а также расположением, в которое вы хотите скопировать его.
Комментарии
Этот метод копирует и содержимое каталога, и сам каталог. Если целевой каталог не существует, он создается. Если каталог с таким же именем существует в целевом расположении, содержимое двух каталогов объединяется. Во время операции можно указать новое имя для каталога.
При копировании файлов в каталоге могут возникать исключения, вызванные определенным файлом. При возникновении таких исключений они объединяются в одно исключение, свойство которого Data содержит записи в виде IDictionary , в котором путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении. Используйте For…Each для перечисления по записям.
В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyDirectory .
| Кому | См. |
|---|---|
| Копирование каталога | Практическое руководство. Копирование каталога в другой каталог |
См. также раздел
- UICancelOption
- Объекты (Visual Basic)
- Практическое руководство. Получение коллекции содержащихся в каталоге файлов в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
CopyDirectory(String, String, Boolean)
Копирует каталог в другой каталог.
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 -> unitPublic 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 .
| Кому | См. |
|---|---|
| Копирование каталога | Практическое руководство. Копирование каталога в другой каталог |
См. также раздел
- UICancelOption
- Объекты (Visual Basic)
- Практическое руководство. Получение коллекции содержащихся в каталоге файлов в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
CopyDirectory(String, String, UIOption, UICancelOption)
Копирует каталог в другой каталог.
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 -> unitPublic 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", True)
Замените C:\TestDirectory1 и C:\TestDirectory2 на путь и имя каталога, который вы хотите скопировать, и расположением, в которое вы хотите скопировать его.
Комментарии
Этот метод копирует и содержимое каталога, и сам каталог. Если целевой каталог не существует, он создается. Если каталог с таким же именем существует в целевом расположении, содержимое двух каталогов объединяется. Во время операции можно указать новое имя для каталога.
При копировании файлов в каталоге могут возникать исключения, вызванные определенным файлом. При возникновении таких исключений они объединяются в одно исключение, свойство которого Data содержит записи в виде IDictionary , в котором путь к файлу или каталогу является ключом, а конкретное сообщение об исключении содержится в соответствующем значении. Используйте For…Each для перечисления по записям.
В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyDirectory .
| Кому | См. |
|---|---|
| Копирование каталога | Практическое руководство. Копирование каталога в другой каталог |
См. также раздел
- UICancelOption
- Объекты (Visual Basic)
- Практическое руководство. Получение коллекции содержащихся в каталоге файлов в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по