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

Статья
11/05/2008

Обновлен: Ноябрь 2007

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).