FileInfo.CopyTo Method (String)

FileInfoCopyTo Method (String)

Copies an existing file to a new file, disallowing the overwriting of an existing file.

Namespace: Alphaleonis.Win32.Filesystem
Assembly: AlphaFS (in AlphaFS.dll) Version: 2.0

Syntax

public FileInfo CopyTo(
	string destinationPath
)

Public Function CopyTo ( 
	destinationPath As String
) As FileInfo

public:
FileInfo^ CopyTo(
	String^ destinationPath
)

member CopyTo : 
        destinationPath : string -> FileInfo

Type: FileInfo
Returns a new FileInfo instance with a fully qualified path.

Exceptions

Exception	Condition
ArgumentException	destinationPath contains invalid characters, is empty, or contains only white spaces.
ArgumentNullException	destinationPath is .
DirectoryNotFoundException	.
FileNotFoundException	.
IOException	.
NotSupportedException	.
UnauthorizedAccessException	.

Remarks

Use this method to prevent overwriting of an existing file by default.

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.