FileInfo.MoveTo Method (String)

FileInfoMoveTo Method (String)

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

Namespace: Alphaleonis.Win32.Filesystem
Assembly: AlphaFS (in AlphaFS.dll) Version: 2.0

Syntax

public void MoveTo(
	string destinationPath
)

Public Sub MoveTo ( 
	destinationPath As String
)

public:
void MoveTo(
	String^ destinationPath
)

member MoveTo : 
        destinationPath : string -> unit

destinationPath: Type: SystemString
The path to move the file to, which can specify a different file name.

Exceptions

Exception	Condition
ArgumentException	Passed when the path parameter contains invalid characters, is empty, or contains only white spaces.
ArgumentNullException	Passed when path is .
DirectoryNotFoundException	Passed when the directory was not found.
FileNotFoundException	Passed if the file was not found.
IOException	Passed when an I/O error occurs.
NotSupportedException
UnauthorizedAccessException

Remarks

Use this method to prevent overwriting of an existing file by default.

This method works across disk volumes.

For example, the file c:\MyFile.txt can be moved to d:\public and renamed NewFile.txt.

Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method.

If two files have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.