FileInfoCopyTo Method (String, CopyOptions, Boolean, CopyMoveProgressRoutine, Object, PathFormat) |
[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file,
CopyOptions can be specified.
and the possibility of notifying the application of its progress through a callback function.
Remarks Option NoBuffering is recommended for very large file transfers.
Use this method to allow or prevent overwriting of 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 CopyMoveResult CopyTo(
string destinationPath,
CopyOptions copyOptions,
bool preserveDates,
CopyMoveProgressRoutine progressHandler,
Object userProgressData,
PathFormat pathFormat
)
Public Function CopyTo (
destinationPath As String,
copyOptions As CopyOptions,
preserveDates As Boolean,
progressHandler As CopyMoveProgressRoutine,
userProgressData As Object,
pathFormat As PathFormat
) As CopyMoveResult
public:
CopyMoveResult^ CopyTo(
String^ destinationPath,
CopyOptions copyOptions,
bool preserveDates,
CopyMoveProgressRoutine^ progressHandler,
Object^ userProgressData,
PathFormat pathFormat
)
member CopyTo :
destinationPath : string *
copyOptions : CopyOptions *
preserveDates : bool *
progressHandler : CopyMoveProgressRoutine *
userProgressData : Object *
pathFormat : PathFormat -> CopyMoveResult
Parameters
- destinationPath
- Type: SystemString
The name of the new file to copy to. - copyOptions
- Type: Alphaleonis.Win32.FilesystemCopyOptions
CopyOptions that specify how the file is to be copied. - preserveDates
- Type: SystemBoolean
if original Timestamps must be preserved, otherwise. - progressHandler
- Type: Alphaleonis.Win32.FilesystemCopyMoveProgressRoutine
A callback function that is called each time another portion of the file has been copied. 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 details of the Copy action.
Exceptions See Also