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

Статья
08/11/2011

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