[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Moves a specified file to a new location, providing the option to specify a new file name.
Assembly: mscorlib (in mscorlib.dll)
An I/O error occurs, such as the destination file already exists or the destination device is not ready.
destFileName is null.
destFileName is empty, contains only white spaces, or contains invalid characters.
The caller does not have the required permission.
destFileName is read-only or is a directory.
The file is not found.
The specified path is invalid, such as being on an unmapped drive.
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.
destFileName contains a colon (:) in the middle of the string.