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


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

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

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

Чтобы переместить файл

  • Для перемещения файла используйте метод MoveFile, указав имя файла и местоположение исходного и конечного файлов. В этом примере файл test.txt перемещается из каталога TestDir1 в каталог TestDir2. Обратите внимание, что даже если имя файла назначения совпадает с именем исходного файла, его все равно необходимо указывать.

    My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", _
        "C:\TestDir2\test.txt")
    

Чтобы переместить файл и переименовать его

  • Для перемещения файла используйте метод MoveFile, указав имя исходного файла, местоположение назначения и новое имя файла в этом местоположении. В этом примере файл test.txt перемещается из каталога TestDir1 в каталог TestDir2, и ему присваивается имя nexttest.txt.

    My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", _
        "C:\TestDir2\nexttest.txt", _
        FileIO.UIOption.AllDialogs, _
        FileIO.UICancelOption.ThrowException)
    

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

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

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

  • Путь не является допустимым, поскольку он равен Nothing (ArgumentNullException).

  • Параметр destinationFileName равен Nothing или является пустой строкой (ArgumentNullException).

  • Исходный файл не является допустимым или не существует (FileNotFoundException).

  • Объединенный путь указывает на существующий каталог, файл назначения существует и параметру overwrite присвоено значение False, файл с тем же именем в каталоге назначения уже используется, или у пользователя нет необходимых разрешений для доступа к файлу (IOException).

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

  • Параметр showUI имеет значение True, параметр onUserCancel имеет значение ThrowException, и либо пользователь отменил операцию, либо возникает неизвестная ошибка ввода-вывода (OperationCanceledException).

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

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

  • Пользователь не имеет необходимого разрешения (UnauthorizedAccessException).

См. также

Задачи

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

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

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

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

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

Ссылки

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