FileInfo.MoveTo Method

[ 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.

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

Syntax

Public Sub MoveTo ( _
    destFileName As String _
)

public void MoveTo(
    string destFileName
)

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 nullNothingnullptra null reference (Nothing in Visual Basic).
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.

Windows Phone

This member has a SecurityCriticalAttribute attribute. This attribute restricts this member to internal use. Application code that uses this member throws a MethodAccessException.