FileInfo.CopyTo Method (String, Boolean, PathFormat)

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

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).

Returns 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

Exception	Condition
ArgumentException	Passed when the path parameter contains invalid characters, is empty, or contains only white spaces.
ArgumentNullException	Passed when path is .
DirectoryNotFoundException	Passed when the directory was not found.
FileNotFoundException	Passed if the file was not found.
IOException	Passed when an I/O error occurs.
NotSupportedException
UnauthorizedAccessException

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.