IsolatedStorageFile.DeleteFile Method

Deletes a file in the isolated store.

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

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Sub DeleteFile ( _
    file As String _
)
[SecuritySafeCriticalAttribute]
public void DeleteFile(
    string file
)

Parameters

  • file
    Type: System.String
    The relative path of the file to delete within the isolated store.

Exceptions

Exception Condition
IsolatedStorageException

The store has been removed.

-or-

Unable to delete the file.

-or-

Isolated storage is disabled.

ArgumentException

file is badly formed.

ArgumentNullException

file is nulla null reference (Nothing in Visual Basic).

ObjectDisposedException

The store has been disposed.

Remarks

The deleted file cannot be recovered once deleted.

NoteNote:

File deletions are subject to intermittent failures because files can be in use simultaneously by operating system features such as virus scanners and file indexers. This is especially true for recently created files. Macintosh users should be aware of this issue because of its frequent indexing.

For these reasons, it is important to add code to the code block that handles the IsolatedStorageException to retry deleting the file or log a failure.

Examples

The following example deletes a file from the store. This example is part of a larger example provided for IsolatedStorageFile class.

' Delete a file.
Try
    If store.FileExists(filePath) Then
        store.DeleteFile(filePath)
    End If
Catch ex As IsolatedStorageException
    sb.AppendLine(ex.Message)
End Try
// Delete a file.
try
{
    if (store.FileExists(filePath))
    {
        store.DeleteFile(filePath);
    }
}
catch (IsolatedStorageException ex)
{
    sb.AppendLine(ex.Message);
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

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