Article
11/18/2011

IsolatedStorageFile.DeleteFile Method

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

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.

Note:
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.

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.