IsolatedStorageFile.CopyFile Method (String, String)

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

Copies an existing file to a new file.

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

Syntax

'Declaration
Public Sub CopyFile ( _
    sourceFileName As String, _
    destinationFileName As String _
)
public void CopyFile(
    string sourceFileName,
    string destinationFileName
)

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 or an existing file.

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-

destinationFileName exists.

-or-

An I/O error has occurred.

Remarks

sourceFileName and destinationFileName must specify different file names. Use the IsolatedStorageFile.CopyFile(String, String, Boolean) method overload to overwrite an existing file.

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.