FileInfoCopyTo Method (String, CopyOptions) |
[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file,
CopyOptions can be specified.
Namespace:
Alphaleonis.Win32.Filesystem
Assembly:
AlphaFS (in AlphaFS.dll) Version: 2.0
Syntax public FileInfo CopyTo(
string destinationPath,
CopyOptions copyOptions
)
Public Function CopyTo (
destinationPath As String,
copyOptions As CopyOptions
) As FileInfo
public:
FileInfo^ CopyTo(
String^ destinationPath,
CopyOptions copyOptions
)
member CopyTo :
destinationPath : string *
copyOptions : CopyOptions -> FileInfo
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.
Return Value
Type:
FileInfoReturns a new file, or an overwrite of an existing file if copyOptions is not FailIfExists.
If the file exists and copyOptions contains FailIfExists, an IOException is thrown.
Exceptions 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.
See Also