IsolatedStorageFile::CopyFile Method (String^, String^, Boolean)

.NET Framework (current version)

Copies an existing file to a new file, and optionally overwrites an existing file.

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

Syntax

public:
[ComVisibleAttribute(false)]
void CopyFile(
	String^ sourceFileName,
	String^ destinationFileName,
	bool overwrite
)

Parameters

sourceFileName: Type: System::String^
The name of the file to copy.

destinationFileName: Type: System::String^
The name of the destination file. This cannot be a directory.

overwrite: Type: System::Boolean
true if the destination file can be overwritten; otherwise, false.

Exceptions

Exception	Condition
ArgumentException	sourceFileName or destinationFileName is a zero-length string, contains only white space, or contains one or more invalid characters defined by the Path::GetInvalidPathChars method.
ArgumentNullException	sourceFileName or destinationFileName is null.
InvalidOperationException	The isolated store has been closed.
ObjectDisposedException	The isolated store has been disposed.
FileNotFoundException	sourceFileName was not found.
DirectoryNotFoundException	sourceFileName was not found.
IsolatedStorageException	The isolated store has been removed. -or- Isolated storage is disabled. -or- An I/O error has occurred.

Remarks

sourceFileName and destinationFileName can have the same file name if overwrite is true.

Version Information

Universal Windows Platform
Available since 10
.NET Framework
Available since 4.0
Silverlight
Available since 4.0
Windows Phone Silverlight
Available since 7.1