Partager via


My.Computer.FileSystem.DeleteFile, méthode

Mise à jour : novembre 2007

Supprime un fichier.

' 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 _
)

Paramètres

  • file
    String. Nom et chemin d'accès du fichier à supprimer. Obligatoire.

  • showUI
    UIOption. Si besoin d'un suivi visuel de l'avancement de l'opération. La valeur par défaut est UIOption.OnlyErrorDialogs. Obligatoire.

  • recycle
    RecycleOption. Spécifie si le fichier supprimé doit être envoyé à la Corbeille. La valeur par défaut est RecycleOption.DeletePermanently. Obligatoire.

  • onUserCancel
    UICancelOption. Spécifie si une exception est levée lorsque l'utilisateur annule l'opération. La valeur par défaut est UICancelOption.ThrowException. Obligatoire.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

  • Le chemin d'accès n'est pas valide pour une des raisons suivantes : il s'agit d'une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ; il contient une barre oblique finale où un fichier doit être spécifié ou il s'agit d'un chemin d'accès de périphérique (qui commence par \\.\) (ArgumentException).

  • Le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException).

  • Le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException).

  • Un nom de fichier ou de répertoire du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException).

  • Le fichier est en cours d'utilisation (IOException).

  • L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException).

  • Le fichier n'existe pas (FileNotFoundException).

  • L'utilisateur n'a pas l'autorisation pour supprimer le fichier ou le fichier est en lecture seule (UnauthorizedAccessException).

  • Situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose pas des autorisations nécessaires (SecurityException).

  • L'utilisateur a annulé l'opération et onUserCancel a la valeur UICancelOption.ThrowException (OperationCanceledException).

Notes

Les paramètres showUI, recycle et onUserCancel ne sont pas pris en charge dans les applications qui ne sont pas interactives avec l'utilisateur, telles que les services Windows.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.FileSystem.DeleteFile.

Pour

Consultez

Supprimer un fichier

Comment : supprimer un fichier dans Visual Basic

Supprimer tous les fichiers d'un répertoire

Comment : supprimer tous les fichiers d'un répertoire dans Visual Basic

Exemple

Cet exemple supprime le fichier Test.txt.

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

Cet exemple supprime le fichier Test.txt et permet à l'utilisateur de confirmer sa suppression.

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

Cet exemple supprime le fichier Test.txt et l'envoie à la Corbeille.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :FileSystemProxy (fournit l'accès à FileSystem)

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet

Disponible

Application Windows

Oui

Bibliothèque de classes

Oui

Application console

Oui

Bibliothèque de contrôles Windows

Oui

Bibliothèque de contrôles Web

Oui

Service Windows

Oui

Site Web

Oui

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Autorisation

Description

FileIOPermission

Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.

UIPermission

Contrôle les autorisations relatives aux interfaces utilisateur et au presse-papiers. Énumération associée : SafeSubWindows.

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Tâches

Comment : supprimer un répertoire dans Visual Basic

Référence

My.Computer.FileSystem, objet

UIOption, énumération

RecycleOption, énumération

UICancelOption, énumération

FileSystem.DeleteFile

My.Computer.FileSystem, objet