File.Copy Method (String, String, CopyOptions, Boolean, PathFormat)

FileCopy Method (String, String, CopyOptions, Boolean, PathFormat)

[AlphaFS] Copies an existing file to a new file. Overwriting a file of the same name is allowed. CopyOptions can be specified.

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

Syntax

C++

Copy

public static void Copy(
	string sourceFileName,
	string destinationFileName,
	CopyOptions copyOptions,
	bool preserveDates,
	PathFormat pathFormat
)

Public Shared Sub Copy ( 
	sourceFileName As String,
	destinationFileName As String,
	copyOptions As CopyOptions,
	preserveDates As Boolean,
	pathFormat As PathFormat
)

public:
static void Copy(
	String^ sourceFileName, 
	String^ destinationFileName, 
	CopyOptions copyOptions, 
	bool preserveDates, 
	PathFormat pathFormat
)

static member Copy : 
        sourceFileName : string * 
        destinationFileName : string * 
        copyOptions : CopyOptions * 
        preserveDates : bool * 
        pathFormat : PathFormat -> unit

Parameters

sourceFileName: Type: SystemString
The file to copy.
destinationFileName: Type: SystemString
The name of the destination file. This cannot be a directory.
copyOptions: Type: Alphaleonis.Win32.FilesystemCopyOptions
CopyOptions that specify how the file is to be copied. This parameter can be .
preserveDates: Type: SystemBoolean
if original Timestamps must be preserved, otherwise.
pathFormat: Type: Alphaleonis.Win32.FilesystemPathFormat
Indicates the format of the path parameter(s).

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

Option NoBuffering is recommended for very large file transfers.

The attributes of the original file are retained in the copied 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.

Reference

File Class

Copy Overload

Alphaleonis.Win32.Filesystem Namespace