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


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

Обновлен: Ноябрь 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).

См. также

Задачи

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

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

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

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

Ссылки

Объект My.Computer.FileSystem

Метод My.Computer.FileSystem.CopyFile

Перечисление UICancelOption