FileInfoCopyTo Method (String, Boolean, PathFormat) |
[AlphaFS] Copies an existing file to a new file, allowing the overwriting of an existing file.
Namespace:
Alphaleonis.Win32.Filesystem
Assembly:
AlphaFS (in AlphaFS.dll) Version: 2.0
Syntax public FileInfo CopyTo(
string destinationPath,
bool overwrite,
PathFormat pathFormat
)
Public Function CopyTo (
destinationPath As String,
overwrite As Boolean,
pathFormat As PathFormat
) As FileInfo
public:
FileInfo^ CopyTo(
String^ destinationPath,
bool overwrite,
PathFormat pathFormat
)
member CopyTo :
destinationPath : string *
overwrite : bool *
pathFormat : PathFormat -> FileInfo
Parameters
- destinationPath
- Type: SystemString
The name of the new file to copy to. - overwrite
- Type: SystemBoolean
to allow an existing file to be overwritten; otherwise, . - pathFormat
- Type: Alphaleonis.Win32.FilesystemPathFormat
Indicates the format of the path parameter(s).
Return Value
Type:
FileInfoReturns a new file, or an overwrite of an existing file if overwrite is .
If the file exists and overwrite is , an IOException is thrown.
Exceptions Remarks 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