FileSystem.MoveFile Метод

Ссылка

Определение

Пространство имен:: Microsoft.VisualBasic.FileIO

Сборка:: Microsoft.VisualBasic.Core.dll

Сборка:: Microsoft.VisualBasic.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перемещает файл в новое местоположение.

Перегрузки

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)

Параметры

sourceFileName: String

Путь к перемещаемому файлу.

destinationFileName: String

Путь к каталогу, в который необходимо переместить файл.

Исключения

ArgumentException

Путь недопустим по одной из следующих причин: это строка нулевой длины; содержит только пробелы; содержит недопустимые символы; или это путь к устройству (начинается с \\.\); заканчивается косой чертой в конце.

ArgumentNullException

Параметр destinationFileName имеет значение Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Файл уже используется другим процессом или возникла ошибка ввода-вывода.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В данном примере перемещается файл с именем 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

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Параметры

sourceFileName: String

Путь к перемещаемому файлу.

destinationFileName: String

Путь к каталогу, в который необходимо переместить файл.

showUI: UIOption

Указывает, следует ли отображать ход выполнения операции. Значение по умолчанию — UIOption.OnlyErrorDialogs.

Исключения

ArgumentException

ArgumentNullException

Параметр destinationFileName имеет значение Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Файл уже используется другим процессом или возникла ошибка ввода-вывода.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В данном примере перемещается файл с именем 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")

См. также раздел

UIOption

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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 -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Параметры

sourceFileName: String

Путь к перемещаемому файлу.

destinationFileName: String

Путь к каталогу, в который необходимо переместить файл.

overwrite: Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False. Значение по умолчанию — False.

Исключения

ArgumentException

ArgumentNullException

Параметр destinationFileName имеет значение Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Файл уже используется другим процессом или возникла ошибка ввода-вывода.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В данном примере перемещается файл с именем 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")

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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 -> unit

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

Исключения

ArgumentException

ArgumentNullException

Параметр destinationFileName имеет значение Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Файл уже используется другим процессом или возникла ошибка ввода-вывода.

OperationCanceledException

onUserCancel имеет значение ThrowException, а пользователь отменил операцию, или возникла ошибка ввода-вывода.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В данном примере перемещается файл с именем 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")

См. также раздел

Применяется к

.NET 9 и другие версии

Продукт	Версии
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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

FileSystem.MoveFile Метод

Определение

Перегрузки

MoveFile(String, String)

Параметры

Исключения

Примеры

Комментарии

Применяется к

MoveFile(String, String, UIOption)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

MoveFile(String, String, Boolean)

Параметры

Исключения

Примеры

Комментарии

Применяется к

MoveFile(String, String, UIOption, UICancelOption)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы