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


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

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

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

Ссылки

MoveFile