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

  • Статья

Метод 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).

См. также