Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

FileInfo::MoveTo Method (String^)

 

Moves a specified file to a new location, providing the option to specify a new file name.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public:
void MoveTo(
	String^ destFileName
)

Parameters

destFileName
Type: System::String^

The path to move the file to, which can specify a different file name.

Exception Condition
IOException

An I/O error occurs, such as the destination file already exists or the destination device is not ready.

ArgumentNullException

destFileName is null.

ArgumentException

destFileName is empty, contains only white spaces, or contains invalid characters.

SecurityException

The caller does not have the required permission.

UnauthorizedAccessException

destFileName is read-only or is a directory.

FileNotFoundException

The file is not found.

DirectoryNotFoundException

The specified path is invalid, such as being on an unmapped drive.

PathTooLongException

The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.

NotSupportedException

destFileName contains a colon (:) in the middle of the string.

This method works across disk volumes. For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt.

The following example demonstrates moving a file to a different location and renaming the file.

No code example is currently available or this language may not be supported.

FileIOPermission

for reading and writing files. Associated enumerations: FileIOPermissionAccess::Read, FileIOPermissionAccess::Write

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show:
© 2017 Microsoft