FileInfo::MoveTo Method (String^)
Moves a specified file to a new location, providing the option to specify a new file name.
Assembly: mscorlib (in mscorlib.dll)
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.
for reading and writing files. Associated enumerations: FileIOPermissionAccess::Read, FileIOPermissionAccess::Write
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0