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