FileSystem.MoveFile Метод

Определение

Перемещает файл в новое местоположение.Moves a file to a new location.

Перегрузки

MoveFile(String, String)

Перемещает файл в новое местоположение.Moves a file to a new location.

MoveFile(String, String, UIOption)

Перемещает файл в новое местоположение.Moves a file to a new location.

MoveFile(String, String, Boolean)

Перемещает файл в новое местоположение.Moves a file to a new location.

MoveFile(String, String, UIOption, UICancelOption)

Перемещает файл в новое местоположение.Moves a file to a new location.

MoveFile(String, String)

Перемещает файл в новое местоположение.Moves a file to a new location.

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

Путь к перемещаемому файлу.Path of the file to be moved.

destinationFileName
String

Путь к каталогу, в который необходимо переместить файл.Path of the directory into which the file should be moved.

Исключения

Путь является недопустимым, так как либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\); заканчивается косой чертой.The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\); it ends with a trailing slash.

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

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Файл уже используется другим процессом или возникла ошибка ввода-вывода.The file is in use by another process, or an I/O error occurs.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере файл перемещается Test.txt из TestDir1 в TestDir2.This example moves the file Test.txt from TestDir1 to TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

В этом примере файл Test.txt перемещается из TestDir1 в TestDir2 и переименовывается Test2.txt.This example moves the file Test.txt from TestDir1 to TestDir2 and renames it Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Комментарии

Если целевая структура не существует, она будет создана.If the target structure does not exist, it is created.

Метод MoveFile сохраняет ACE (записи контроля доступа) только при перемещении файла в пределах одного тома.The MoveFile method preserves ACEs (Access Control Entries) only when moving the file within the same volume. Сюда входят унаследованные ACE, которые становятся прямыми записями ACE при перемещении (прямые записи ACE имеют приоритет над унаследованными элементами ACE).This includes inherited ACEs, which become direct ACEs when moved (direct ACEs take precedence over inherited ACEs). Если файл перемещается между томами, записи ACE не будут скопированы.If a file is moved between volumes, ACEs will not be copied.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.MoveFile.The following table lists an example of a task involving the My.Computer.FileSystem.MoveFile method.

КомуTo См.See
Перемещение файлаMove a file Практическое руководство. Перемещение файла в Visual BasicHow to: Move a File in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

MoveFile(String, String, UIOption)

Перемещает файл в новое местоположение.Moves a file to a new location.

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

Путь к перемещаемому файлу.Path of the file to be moved.

destinationFileName
String

Путь к каталогу, в который необходимо переместить файл.Path of the directory into which the file should be moved.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Specifies whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

Исключения

Путь является недопустимым, так как либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\); заканчивается косой чертой.The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\); it ends with a trailing slash.

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

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Файл уже используется другим процессом или возникла ошибка ввода-вывода.The file is in use by another process, or an I/O error occurs.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере файл перемещается Test.txt из TestDir1 в TestDir2.This example moves the file Test.txt from TestDir1 to TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

В этом примере файл Test.txt перемещается из TestDir1 в TestDir2 и переименовывается Test2.txt.This example moves the file Test.txt from TestDir1 to TestDir2 and renames it Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Комментарии

Если целевая структура не существует, она будет создана.If the target structure does not exist, it is created.

Метод MoveFile сохраняет ACE (записи контроля доступа) только при перемещении файла в пределах одного тома.The MoveFile method preserves ACEs (Access Control Entries) only when moving the file within the same volume. Сюда входят унаследованные ACE, которые становятся прямыми записями ACE при перемещении (прямые записи ACE имеют приоритет над унаследованными элементами ACE).This includes inherited ACEs, which become direct ACEs when moved (direct ACEs take precedence over inherited ACEs). Если файл перемещается между томами, записи ACE не будут скопированы.If a file is moved between volumes, ACEs will not be copied.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.MoveFile.The following table lists an example of a task involving the My.Computer.FileSystem.MoveFile method.

КомуTo См.See
Перемещение файлаMove a file Практическое руководство. Перемещение файла в Visual BasicHow to: Move a File in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

MoveFile(String, String, Boolean)

Перемещает файл в новое местоположение.Moves a file to a new location.

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

Путь к перемещаемому файлу.Path of the file to be moved.

destinationFileName
String

Путь к каталогу, в который необходимо переместить файл.Path of the directory into which the file should be moved.

overwrite
Boolean

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

Исключения

Путь является недопустимым, так как либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\); заканчивается косой чертой.The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\); it ends with a trailing slash.

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

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Файл уже используется другим процессом или возникла ошибка ввода-вывода.The file is in use by another process, or an I/O error occurs.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере файл перемещается Test.txt из TestDir1 в TestDir2.This example moves the file Test.txt from TestDir1 to TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

В этом примере файл Test.txt перемещается из TestDir1 в TestDir2 и переименовывается Test2.txt.This example moves the file Test.txt from TestDir1 to TestDir2 and renames it Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Комментарии

Если целевая структура не существует, она будет создана.If the target structure does not exist, it is created.

Метод MoveFile сохраняет ACE (записи контроля доступа) только при перемещении файла в пределах одного тома.The MoveFile method preserves ACEs (Access Control Entries) only when moving the file within the same volume. Сюда входят унаследованные ACE, которые становятся прямыми записями ACE при перемещении (прямые записи ACE имеют приоритет над унаследованными элементами ACE).This includes inherited ACEs, which become direct ACEs when moved (direct ACEs take precedence over inherited ACEs). Если файл перемещается между томами, записи ACE не будут скопированы.If a file is moved between volumes, ACEs will not be copied.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.MoveFile.The following table lists an example of a task involving the My.Computer.FileSystem.MoveFile method.

КомуTo См.See
Перемещение файлаMove a file Практическое руководство. Перемещение файла в Visual BasicHow to: Move a File in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

MoveFile(String, String, UIOption, UICancelOption)

Перемещает файл в новое местоположение.Moves a file to a new location.

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

Путь к перемещаемому файлу.Path of the file to be moved.

destinationFileName
String

Путь к каталогу, в который необходимо переместить файл.Path of the directory into which the file should be moved.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Specifies whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

onUserCancel
UICancelOption

Указывает, выдается ли исключение, когда пользователь отменяет операцию.Specifies whether or not an exception is thrown when the user cancels the operation. Значение по умолчанию — UICancelOption.ThrowException.Default is UICancelOption.ThrowException.

Исключения

Путь является недопустимым, так как либо представляет собой строку нулевой длины (пустую строку), либо содержит только пробел, либо содержит недопустимые символы, либо представляет собой путь к устройству (начинается с символов \\.\); заканчивается косой чертой.The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\); it ends with a trailing slash.

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

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Файл уже используется другим процессом или возникла ошибка ввода-вывода.The file is in use by another process, or an I/O error occurs.

onUserCancel имеет значение ThrowException, а пользователь отменил операцию, или возникла ошибка ввода-вывода.onUserCancel is set to ThrowException, and either the user has cancelled the operation or an unspecified I/O error occurs.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере файл перемещается Test.txt из TestDir1 в TestDir2.This example moves the file Test.txt from TestDir1 to TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

В этом примере файл Test.txt перемещается из TestDir1 в TestDir2 и переименовывается Test2.txt.This example moves the file Test.txt from TestDir1 to TestDir2 and renames it Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Комментарии

Если целевая структура не существует, она будет создана.If the target structure does not exist, it is created.

Метод MoveFile сохраняет ACE (записи контроля доступа) только при перемещении файла в пределах одного тома.The MoveFile method preserves ACEs (Access Control Entries) only when moving the file within the same volume. Сюда входят унаследованные ACE, которые становятся прямыми записями ACE при перемещении (прямые записи ACE имеют приоритет над унаследованными элементами ACE).This includes inherited ACEs, which become direct ACEs when moved (direct ACEs take precedence over inherited ACEs). Если файл перемещается между томами, записи ACE не будут скопированы.If a file is moved between volumes, ACEs will not be copied.

В следующей таблице приведен пример задачи, включающей метод My.Computer.FileSystem.MoveFile.The following table lists an example of a task involving the My.Computer.FileSystem.MoveFile method.

КомуTo См.See
Перемещение файлаMove a file Практическое руководство. Перемещение файла в Visual BasicHow to: Move a File in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

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