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