Click or drag to resize
FileInfoMoveTo Method (String, MoveOptions, PathFormat)
[AlphaFS] Moves a specified file to a new location, providing the option to specify a new file name, MoveOptions can be specified.

Namespace: Alphaleonis.Win32.Filesystem
Assembly: AlphaFS (in AlphaFS.dll) Version: 2.0
Syntax
public FileInfo MoveTo(
	string destinationPath,
	MoveOptions moveOptions,
	PathFormat pathFormat
)

Parameters

destinationPath
Type: SystemString
The path to move the file to, which can specify a different file name.
moveOptions
Type: Alphaleonis.Win32.FilesystemMoveOptions
MoveOptions that specify how the directory is to be moved. This parameter can be .
pathFormat
Type: Alphaleonis.Win32.FilesystemPathFormat
Indicates the format of the path parameter(s).

Return Value

Type: FileInfo

Returns a new FileInfo instance with a fully qualified path when successfully moved,

Exceptions
ExceptionCondition
ArgumentExceptionPassed when the path parameter contains invalid characters, is empty, or contains only white spaces.
ArgumentNullExceptionPassed when path is .
DirectoryNotFoundExceptionPassed when the directory was not found.
FileNotFoundExceptionPassed if the file was not found.
IOExceptionPassed when an I/O error occurs.
NotSupportedException
UnauthorizedAccessException
Remarks

Use this method to allow or prevent overwriting of an existing file.

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.

See Also