Metodo My.Computer.FileSystem.DeleteFile

Articolo
09/12/2008

Aggiornamento: novembre 2007

Elimina un file.

' Usage
My.Computer.FileSystem.DeleteFile(file)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteFile( _
   ByVal file As String _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

Parametri

file
String. Nome e percorso dei file da eliminare. Obbligatorio.
showUI
UIOption. Consente di specificare se eseguire il monitoraggio dell'avanzamento dell'operazione. Il valore predefinito è UIOption.OnlyErrorDialogs. Obbligatorio.
recycle
RecycleOption. Indica se il file eliminato deve essere inviato al Cestino. Il valore predefinito è RecycleOption.DeletePermanently. Obbligatorio.
onUserCancel
UICancelOption. Specifica se viene generata un'eccezione quando l'utente annulla l'operazione. Il valore predefinito è UICancelOption.ThrowException. Obbligatorio.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi, presenta una barra finale nel punto in cui è necessario specificare un file o è il percorso di una periferica, vale a dire inizia con \\.\ (ArgumentException).
Il percorso non è valido in quanto Nothing (ArgumentNullException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).
Il file è in uso (IOException).
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).
Il file non esiste (FileNotFoundException).
L'utente non dispone delle autorizzazioni necessarie per eliminare il file oppure questo è di sola lettura (UnauthorizedAccessException).
Sussiste una situazione di attendibilità parziale in cui l'utente non dispone delle autorizzazioni necessarie (SecurityException).
L'utente ha annullato l'operazione e il parametro onUserCancel è impostato su UICancelOption.ThrowException (OperationCanceledException).

Note

I parametri showUI, recycle e onUserCancel non sono supportati nelle applicazioni non interattive con l'utente, ad esempio i servizi Windows.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.DeleteFile.

Per	Vedere
Per eliminare un file	Procedura: eliminare un file in Visual Basic
Per eliminare tutti i file di una directory	Procedura: eliminare tutti i file in una directory in Visual Basic

Esempio

Nell'esempio viene eliminato il file Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Nell'esempio, viene eliminato il file Test.txt e viene consentito all'utente di confermare l'eliminazione.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

In questo esempio, il file Test.txt viene eliminato e inviato al Cestino.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.OnlyErrorDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce l'accesso a FileSystem)

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controllo Web	Sì
Servizio Windows	Sì
Sito Web	Sì

Autorizzazioni

Possono essere necessarie le autorizzazioni seguenti:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
UIPermission	Controlla le autorizzazioni correlate alle interfacce utente e agli Appunti. Enumerazione associata: SafeSubWindows.