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

Статья
06/10/2015

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

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