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
Перемещает файл в новое местоположение.
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 перемещается из TestDir1 в TestDir2 и переименовывает его Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет ACE (контроль доступа Записи) только при перемещении файла в том же томе. Сюда входят наследуемые ACE, которые становятся прямыми ACE при перемещении (прямые ACE имеют приоритет над унаследованными ACE). При перемещении файла между томами ACE не копируются.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод .
| Кому | См. |
|---|---|
| Перемещение файла | Практическое руководство. Перемещение файла в Visual Basic |
Применяется к
MoveFile(String, String, UIOption)
- Исходный код:
- 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 перемещается из TestDir1 в TestDir2 и переименовывает его Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет ACE (контроль доступа Записи) только при перемещении файла в том же томе. Сюда входят наследуемые ACE, которые становятся прямыми ACE при перемещении (прямые ACE имеют приоритет над унаследованными ACE). При перемещении файла между томами ACE не копируются.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод .
| Кому | См. |
|---|---|
| Перемещение файла | Практическое руководство. Перемещение файла в Visual Basic |
См. также раздел
Применяется к
MoveFile(String, String, Boolean)
- Исходный код:
- 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 перемещается из TestDir1 в TestDir2 и переименовывает его Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет ACE (контроль доступа Записи) только при перемещении файла в том же томе. Сюда входят наследуемые ACE, которые становятся прямыми ACE при перемещении (прямые ACE имеют приоритет над унаследованными ACE). При перемещении файла между томами ACE не копируются.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод .
| Кому | См. |
|---|---|
| Перемещение файла | Практическое руководство. Перемещение файла в Visual Basic |
Применяется к
MoveFile(String, String, UIOption, UICancelOption)
- Исходный код:
- 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 перемещается из TestDir1 в TestDir2 и переименовывает его Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Комментарии
Если целевая структура не существует, она создается.
Метод MoveFile сохраняет ACE (контроль доступа Записи) только при перемещении файла в том же томе. Сюда входят наследуемые ACE, которые становятся прямыми ACE при перемещении (прямые ACE имеют приоритет над унаследованными ACE). При перемещении файла между томами ACE не копируются.
В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод .
| Кому | См. |
|---|---|
| Перемещение файла | Практическое руководство. Перемещение файла в Visual Basic |
См. также раздел
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по