Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

FileInfo.Delete Method

Definition

Namespace:
System.IO
Assemblies:
mscorlib.dll, System.IO.FileSystem.dll
Assemblies:
netstandard.dll, System.Runtime.dll
Assemblies:
netstandard.dll, System.IO.FileSystem.dll
Assemblies:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Permanently deletes a file.

public:
 override void Delete();
public override void Delete();
override this.Delete : unit -> unit
Public Overrides Sub Delete ()

Exceptions

The target file is open or memory-mapped on a computer running Microsoft Windows NT.

-or-

There is an open handle on the file, and the operating system is Windows XP or earlier. This open handle can result from enumerating directories and files. For more information, see How to: Enumerate Directories and Files.

The caller does not have the required permission.

The path is a directory.

Examples

The following example demonstrates the Delete method.

using System;
using System.IO;

class Test
{
 
 public static void Main()
 {
 string path = @"c:\MyTest.txt";
 FileInfo fi1 = new FileInfo(path);

 try
 {
 using (StreamWriter sw = fi1.CreateText()) {}
 string path2 = path + "temp";
 FileInfo fi2 = new FileInfo(path2);

 //Ensure that the target does not exist.
 fi2.Delete();

 //Copy the file.
 fi1.CopyTo(path2);
 Console.WriteLine("{0} was copied to {1}.", path, path2);

 //Delete the newly created file.
 fi2.Delete();
 Console.WriteLine("{0} was successfully deleted.", path2);
 }
 catch (Exception e)
 {
 Console.WriteLine("The process failed: {0}", e.ToString());
 }
 }
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//c:\MyTest.txt was copied to c:\MyTest.txttemp.
//c:\MyTest.txttemp was successfully deleted.
Imports System.IO
Imports System.Text

Public Class Test

 Public Shared Sub Main()
 Dim path As String = "c:\MyTest.txt"
 Dim fi As FileInfo = New FileInfo(path)

 Try
 Dim sw As StreamWriter = fi.CreateText()
 sw.Close()
 Dim path2 As String = path + "temp"
 Dim fi2 As FileInfo = New FileInfo(path2)

 'Ensure that the target does not exist.
 fi2.Delete()

 'Copy the file.
 fi.CopyTo(path2)
 Console.WriteLine("{0} was copied to {1}.", path, path2)

 'Delete the newly created file.
 fi2.Delete()
 Console.WriteLine("{0} was successfully deleted.", path2)

 Catch e As Exception
 Console.WriteLine("The process failed: {0}", e.ToString())
 End Try
 End Sub
End Class
'This code produces output similar to the following; 
'results may vary based on the computer/file structure/etc.:
'
'c:\MyTest.txt was copied to c:\MyTest.txttemp.
'c:\MyTest.txttemp was successfully deleted.

The following example creates, closes, and deletes a file.

using System;
using System.IO;

public class DeleteTest
{
 public static void Main()
 {
 // Create a reference to a file.
 FileInfo fi = new FileInfo("temp.txt");
 // Actually create the file.
 FileStream fs = fi.Create();
 // Modify the file as required, and then close the file.
 fs.Close();
 // Delete the file.
 fi.Delete();
 }
}
Imports System.IO

Public Class DeleteTest
 Public Shared Sub Main()
 ' Create a reference to a file.
 Dim fi As New FileInfo("temp.txt")
 ' Actually create the file.
 Dim fs As FileStream = fi.Create()
 ' Modify the file as required, and then close the file.
 fs.Close()
 ' Delete the file.
 fi.Delete()
 End Sub
End Class

Remarks

If the file does not exist, this method does nothing.

Applies to

See also


Feedback

Was this page helpful?