FileMoveTransacted Method (KernelTransaction, String, String, MoveOptions, CopyMoveProgressRoutine, Object, PathFormat) |
[AlphaFS] Moves a specified file to a new location, providing the option to specify a new file name.
Remarks This method works across disk volumes.
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.
Namespace:
Alphaleonis.Win32.Filesystem
Assembly:
AlphaFS (in AlphaFS.dll) Version: 2.2
Syntax public static CopyMoveResult MoveTransacted(
KernelTransaction transaction,
string sourcePath,
string destinationPath,
MoveOptions moveOptions,
CopyMoveProgressRoutine progressHandler,
Object userProgressData,
PathFormat pathFormat
)
Public Shared Function MoveTransacted (
transaction As KernelTransaction,
sourcePath As String,
destinationPath As String,
moveOptions As MoveOptions,
progressHandler As CopyMoveProgressRoutine,
userProgressData As Object,
pathFormat As PathFormat
) As CopyMoveResult
public:
static CopyMoveResult^ MoveTransacted(
KernelTransaction^ transaction,
String^ sourcePath,
String^ destinationPath,
MoveOptions moveOptions,
CopyMoveProgressRoutine^ progressHandler,
Object^ userProgressData,
PathFormat pathFormat
)
static member MoveTransacted :
transaction : KernelTransaction *
sourcePath : string *
destinationPath : string *
moveOptions : MoveOptions *
progressHandler : CopyMoveProgressRoutine *
userProgressData : Object *
pathFormat : PathFormat -> CopyMoveResult
Parameters
- transaction
- Type: Alphaleonis.Win32.FilesystemKernelTransaction
The transaction. - sourcePath
- Type: SystemString
The name of the file to move. - destinationPath
- 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 . - progressHandler
- Type: Alphaleonis.Win32.FilesystemCopyMoveProgressRoutine
A callback function that is called each time another portion of the file has been moved. This parameter can be . - userProgressData
- Type: SystemObject
The argument to be passed to the callback function. This parameter can be . - pathFormat
- Type: Alphaleonis.Win32.FilesystemPathFormat
Indicates the format of the path parameter(s).
Return Value
Type:
CopyMoveResultA
CopyMoveResult class with the status of the Move action.
Exceptions See Also