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


Практическое руководство. Перемещение файла в 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).

См. также

Задачи

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

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

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

Ссылки

MoveFile