Click or drag to resize
FileMove Method (KernelTransaction, String, String, MoveOptions)
[AlphaFS] 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 static void Move(
	KernelTransaction transaction,
	string sourceFileName,
	string destinationFileName,
	MoveOptions moveOptions
)

Parameters

transaction
Type: Alphaleonis.Win32.FilesystemKernelTransaction
The transaction.
sourceFileName
Type: SystemString
The name of the file to move.
destinationFileName
Type: SystemString
The new path for the file.
moveOptions
Type: Alphaleonis.Win32.FilesystemMoveOptions
MoveOptions that specify how the file is to be moved. This parameter can be .
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

This method works across disk volumes, and it does not throw an exception if the source and destination are the same.

Note that if you attempt to replace a file by moving a file of the same name into that directory, you get an IOException.

You cannot use the Move method to overwrite an existing file.

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