FileSystem.MoveFile Метод

Определение

Пространство имен:

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

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

Перегрузки

MoveFile(String, String)	Перемещает файл в новое местоположение.
MoveFile(String, String, UIOption)	Перемещает файл в новое местоположение.
MoveFile(String, String, Boolean)	Перемещает файл в новое местоположение.
MoveFile(String, String, UIOption, UICancelOption)	Перемещает файл в новое местоположение.

MoveFile(String, String)

Исходный код:

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

MoveFile(String, String, UIOption)

Исходный код:

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

Комментарии

Если целевая структура не существует, она создается.

Метод MoveFile сохраняет ACE (контроль доступа Записи) только при перемещении файла в том же томе. Сюда входят наследуемые ACE, которые становятся прямыми ACE при перемещении (прямые ACE имеют приоритет над унаследованными ACE). При перемещении файла между томами ACE не копируются.

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод .

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

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

• UIOption

MoveFile(String, String, Boolean)

Исходный код:

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

Комментарии

Если целевая структура не существует, она создается.

Метод MoveFile сохраняет ACE (контроль доступа Записи) только при перемещении файла в том же томе. Сюда входят наследуемые ACE, которые становятся прямыми ACE при перемещении (прямые ACE имеют приоритет над унаследованными ACE). При перемещении файла между томами ACE не копируются.

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод .

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

MoveFile(String, String, UIOption, UICancelOption)

Исходный код:

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

Комментарии

Если целевая структура не существует, она создается.

Метод MoveFile сохраняет ACE (контроль доступа Записи) только при перемещении файла в том же томе. Сюда входят наследуемые ACE, которые становятся прямыми ACE при перемещении (прямые ACE имеют приоритет над унаследованными ACE). При перемещении файла между томами ACE не копируются.

В следующей таблице приведен пример задачи, включающей My.Computer.FileSystem.MoveFile метод .

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

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

• UIOption
• UICancelOption