FileSystem.MoveFile Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перемещает файл в новое расположение.
Перегрузки
| Имя | Описание |
|---|---|
| MoveFile(String, String) |
Перемещает файл в новое расположение. |
| MoveFile(String, String, UIOption) |
Перемещает файл в новое расположение. |
| MoveFile(String, String, Boolean) |
Перемещает файл в новое расположение. |
| MoveFile(String, String, UIOption, UICancelOption) |
Перемещает файл в новое расположение. |
MoveFile(String, String)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
Перемещает файл в новое расположение.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public static void MoveFile(string sourceFileName, string destinationFileName);static member MoveFile : string * string -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)Параметры
- sourceFileName
- String
Путь к перемещаемой папке.
- destinationFileName
- String
Путь к каталогу, в который следует переместить файл.
Исключения
Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь устройства (начинается с \\.\); он заканчивается косой чертой.
destinationFileName имеет Nothing или пустую строку.
Исходный файл недопустим или не существует.
Файл используется другим процессом или возникает ошибка ввода-вывода.
Путь превышает заданную системой максимальную длину.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
Примеры
В данном примере перемещается файл с именем Test.txt из TestDir1 в TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
В этом примере файл Test.txt перемещается из TestDir1TestDir2 него и переименовывает егоTest2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет элементы управления доступом (контроль доступа записи) только при перемещении файла в одном томе. К ним относятся унаследованные acEs, которые становятся прямыми acEs при перемещении (прямые acEs имеют приоритет над унаследованными acEs). Если файл перемещается между томами, службы acEs не будут скопированы.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод.
| Кому | Смотри |
|---|---|
| Перемещение файла | How to: Move a File in Visual Basic |
Применяется к
MoveFile(String, String, UIOption)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
Перемещает файл в новое расположение.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Параметры
- sourceFileName
- String
Путь к перемещаемой папке.
- destinationFileName
- String
Путь к каталогу, в который следует переместить файл.
- showUI
- UIOption
Указывает, следует ли визуально отслеживать ход выполнения операции. По умолчанию — UIOption.OnlyErrorDialogs.
Исключения
Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь устройства (начинается с \\.\); он заканчивается косой чертой.
destinationFileName имеет Nothing или пустую строку.
Исходный файл недопустим или не существует.
Файл используется другим процессом или возникает ошибка ввода-вывода.
Путь превышает заданную системой максимальную длину.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
Примеры
В данном примере перемещается файл с именем Test.txt из TestDir1 в TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
В этом примере файл Test.txt перемещается из TestDir1TestDir2 него и переименовывает егоTest2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет элементы управления доступом (контроль доступа записи) только при перемещении файла в одном томе. К ним относятся унаследованные acEs, которые становятся прямыми acEs при перемещении (прямые acEs имеют приоритет над унаследованными acEs). Если файл перемещается между томами, службы acEs не будут скопированы.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод.
| Кому | Смотри |
|---|---|
| Перемещение файла | How to: Move a File in Visual Basic |
См. также раздел
Применяется к
MoveFile(String, String, Boolean)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
Перемещает файл в новое расположение.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public static void MoveFile(string sourceFileName, string destinationFileName, bool overwrite);static member MoveFile : string * string * bool -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Параметры
- sourceFileName
- String
Путь к перемещаемой папке.
- destinationFileName
- String
Путь к каталогу, в который следует переместить файл.
- overwrite
- Boolean
True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.
Исключения
Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь устройства (начинается с \\.\); он заканчивается косой чертой.
destinationFileName имеет Nothing или пустую строку.
Исходный файл недопустим или не существует.
Файл используется другим процессом или возникает ошибка ввода-вывода.
Путь превышает заданную системой максимальную длину.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
Примеры
В данном примере перемещается файл с именем Test.txt из TestDir1 в TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
В этом примере файл Test.txt перемещается из TestDir1TestDir2 него и переименовывает егоTest2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет элементы управления доступом (контроль доступа записи) только при перемещении файла в одном томе. К ним относятся унаследованные acEs, которые становятся прямыми acEs при перемещении (прямые acEs имеют приоритет над унаследованными acEs). Если файл перемещается между томами, службы acEs не будут скопированы.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод.
| Кому | Смотри |
|---|---|
| Перемещение файла | How to: Move a File in Visual Basic |
Применяется к
MoveFile(String, String, UIOption, UICancelOption)
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
Перемещает файл в новое расположение.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Параметры
- sourceFileName
- String
Путь к перемещаемой папке.
- destinationFileName
- String
Путь к каталогу, в который следует переместить файл.
- showUI
- UIOption
Указывает, следует ли визуально отслеживать ход выполнения операции. По умолчанию — UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Указывает, возникает ли исключение при отмене операции пользователем. По умолчанию — UICancelOption.ThrowException.
Исключения
Путь недействителен по одной из следующих причин: это строка нулевой длины; он содержит только пробелы; он содержит недопустимые символы; или это путь устройства (начинается с \\.\); он заканчивается косой чертой.
destinationFileName имеет Nothing или пустую строку.
Исходный файл недопустим или не существует.
Файл используется другим процессом или возникает ошибка ввода-вывода.
onUserCancel задано значение ThrowException, и пользователь отменил операцию или не указанную ошибку ввода-вывода.
Путь превышает заданную системой максимальную длину.
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.
У пользователя отсутствуют необходимые разрешения для просмотра пути.
Примеры
В данном примере перемещается файл с именем Test.txt из TestDir1 в TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
В этом примере файл Test.txt перемещается из TestDir1TestDir2 него и переименовывает егоTest2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет элементы управления доступом (контроль доступа записи) только при перемещении файла в одном томе. К ним относятся унаследованные acEs, которые становятся прямыми acEs при перемещении (прямые acEs имеют приоритет над унаследованными acEs). Если файл перемещается между томами, службы acEs не будут скопированы.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод.
| Кому | Смотри |
|---|---|
| Перемещение файла | How to: Move a File in Visual Basic |
