MSDN Library

The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

This topic has not yet been rated - Rate this topic

FileInfo.CopyTo Method (String)

Silverlight

Other Versions

When it is called by trusted applications, copies an existing file to a new file, disallowing the overwriting of an existing file.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

public FileInfo CopyTo(
	string destFileName
)

Parameters

destFileName: Type: System.String
The name of the new file to copy to.

Return Value

Type: System.IO.FileInfo
A new file with a fully qualified path.

Exceptions

Exception	Condition
ArgumentException	destFileName is empty, contains only white spaces, or contains invalid characters.
IOException	An error occurs, or the destination file already exists.
SecurityException	The caller does not have the required permission.
ArgumentNullException	destFileName is null.
UnauthorizedAccessException	A directory path is passed in, or the file is being moved to a different drive.
DirectoryNotFoundException	The directory specified in destFileName does not exist.
PathTooLongException	The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
NotSupportedException	destFileName contains a colon (:) in the middle of the string.

Remarks

Platform Notes

Silverlight for Windows Phone

This member has a SecurityCriticalAttribute attribute on Silverlight for Windows Phone, because the attribute was present in Silverlight 3. This attribute restricts this member to internal use. Application code that uses this member throws a MethodAccessException.

Version Information