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


FileSystemProxy.MoveFile Метод

Определение

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

Перегрузки

MoveFile(String, String)

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

MoveFile(String, String, UIOption)

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

MoveFile(String, String, Boolean)

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

MoveFile(String, String, UIOption, UICancelOption)

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

MoveFile(String, String)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public void MoveFile (string sourceFileName, string destinationFileName);
member this.MoveFile : string * string -> unit
Public 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 метод .

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

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

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

MoveFile(String, String, UIOption)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public 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 метод .

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

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

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

MoveFile(String, String, Boolean)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
member this.MoveFile : string * string * bool -> unit
Public 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 .

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

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

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

MoveFile(String, String, UIOption, UICancelOption)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public 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 метод .

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

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

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