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

Статья
11/05/2008

Обновлен: Ноябрь 2007

Метод My.Computer.FileSystem.CopyFile позволяет копировать файлы. Его параметры обеспечивают возможность перезаписи существующих файлов, переименования файлов и отображения хода выполнения операции, а также отмены операции пользователем.

Копирование текстового файла в другую папку

Используйте для копирования файла метод CopyFile, указав файл-источник и целевой каталог. Параметр overwrite позволяет указать, следует ли перезаписывать существующие файлы. В следующем примере кода демонстрируется использование метода CopyFile.

' Copy the file to a new location without overwriting existing file.
My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\testFile.txt", _
    "C:\UserFiles\TestFiles2\testFile.txt")

' Copy the file to a new folder, overwriting existing file.
My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\testFile.txt", _
    "C:\UserFiles\TestFiles2\testFile.txt", _
    FileIO.UIOption.AllDialogs, _
    FileIO.UICancelOption.DoNothing)

' Copy the file to a new folder and rename it.
My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\testFile.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.AllDialogs, _
    FileIO.UICancelOption.DoNothing)

Отказоустойчивость

Исключение может возникнуть при следующих условиях.

Путь может являться недопустимым по одной из следующих причин: путь представляет собой строку нулевой длины (пустую строку); путь содержит только пробелы; путь содержит недопустимые знаки; или путь представляет собой путь к устройству (начинается с \\.\) (ArgumentException).
Системе не удается извлечь абсолютный путь (ArgumentException).
Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).
Исходный файл не является допустимым или не существует (FileNotFoundException).
Комбинированный путь указывает на существующий каталог (IOException).
Файл уже существует, а параметр overwrite имеет значение False (IOException).
Пользователь не имеет необходимых разрешений для доступа к файлу (IOException).
Файл в папке назначения с тем же именем уже используется (IOException).
Имя файла или папки в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).
Параметр ShowUI имеет значение True, параметр onUserCancel имеет значение ThrowException, а пользователь отменил операцию (OperationCanceledException).
Параметр ShowUI имеет значение True, параметр onUserCancel имеет значение ThrowException, и возникла неопределенная ошибка ввода-вывода (OperationCanceledException).
Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).
Пользователь не имеет необходимого разрешения (UnauthorizedAccessException).
У пользователя отсутствуют необходимые разрешения на просмотр пути (SecurityException).