DirectoryInfo.CopyTo Method (String, CopyOptions)

DirectoryInfoCopyTo Method (String, CopyOptions)

[AlphaFS] Copies an existing directory to a new directory, allowing the overwriting of an existing directory, CopyOptions can be specified.

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

Syntax

public DirectoryInfo CopyTo(
	string destinationPath,
	CopyOptions copyOptions
)

Public Function CopyTo ( 
	destinationPath As String,
	copyOptions As CopyOptions
) As DirectoryInfo

public:
DirectoryInfo^ CopyTo(
	String^ destinationPath, 
	CopyOptions copyOptions
)

member CopyTo : 
        destinationPath : string * 
        copyOptions : CopyOptions -> DirectoryInfo

destinationPath: Type: SystemString
The destination directory path.
copyOptions: Type: Alphaleonis.Win32.FilesystemCopyOptions
CopyOptions that specify how the directory is to be copied. This parameter can be .

Returns a new directory, or an overwrite of an existing directory if copyOptions is not FailIfExists.

If the directory exists and copyOptions contains FailIfExists, 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.
IOException	Passed when an I/O error occurs.
NotSupportedException
UnauthorizedAccessException

Remarks

Option NoBuffering is recommended for very large file transfers.

Use this method to allow or prevent overwriting of an existing directory.

Whenever possible, avoid using short file names (such as XXXXXX~1.XXX) with this method.

If two directories have equivalent short file names then this method may fail and raise an exception and/or result in undesirable behavior.