• Article

IsolatedStorageFile.CopyFile Method (String, String, Boolean)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Sub CopyFile ( _
    sourceFileName As String, _
    destinationFileName As String, _
    overwrite As Boolean _
)

[SecuritySafeCriticalAttribute]
public 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 nulla null reference (Nothing in Visual Basic).
InvalidOperationException

The isolated store has been closed.
ObjectDisposedException

The isolated store has been disposed.
FileNotFoundException

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

Silverlight

Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.