FileSystemProxy.DeleteFile Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Supprime un fichier.

Surcharges

DeleteFile(String)	Supprime un fichier.
DeleteFile(String, UIOption, RecycleOption)	Supprime un fichier.
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	Supprime un fichier.

DeleteFile(String)

Supprime un fichier.

public:
 void DeleteFile(System::String ^ file);

public void DeleteFile (string file);

member this.DeleteFile : string -> unit

Public Sub DeleteFile (file As String)

Paramètres

file

String

Nom et chemin d'accès du fichier à supprimer.

Exceptions

ArgumentException

Le chemin d’accès n’est pas valide pour l’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 a une barre oblique de fin où un fichier doit être spécifié ; ou il s’agit d’un chemin d’appareil (commence par \\.\).

ArgumentNullException

file est soit Nothing soit une chaîne vide.

PathTooLongException

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

NotSupportedException

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

IOException

Le fichier est en cours d'utilisation.

SecurityException

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

FileNotFoundException

Le fichier n'existe pas.

UnauthorizedAccessException

L'utilisateur n'a pas l'autorisation nécessaire pour supprimer le fichier ou le fichier est en lecture seule.

Exemples

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 que le fichier doit être supprimé.

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)

Remarques

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

À	Consultez
Pour supprimer un fichier	Procédure : supprimer un fichier

Voir aussi

• Objets (Visual Basic)
• Guide pratique pour supprimer un fichier dans Visual Basic

DeleteFile(String, UIOption, RecycleOption)

Supprime un fichier.

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption)

Paramètres

file

String

Nom et chemin d'accès du fichier à supprimer.

showUI

UIOption

Indique si un suivi visuel de l'avancement de l'opération est nécessaire. La valeur par défaut est UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Indique si le fichier supprimé doit ou non être envoyé à la Corbeille. La valeur par défaut est RecycleOption.DeletePermanently.

Exceptions

ArgumentException

Le chemin d’accès n’est pas valide pour l’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 a une barre oblique de fin où un fichier doit être spécifié ; ou il s’agit d’un chemin d’appareil (commence par \\.\).

ArgumentNullException

file est soit Nothing soit une chaîne vide.

PathTooLongException

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

NotSupportedException

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

IOException

Le fichier est en cours d'utilisation.

SecurityException

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

FileNotFoundException

Le fichier n'existe pas.

UnauthorizedAccessException

L'utilisateur n'a pas l'autorisation nécessaire pour supprimer le fichier ou le fichier est en lecture seule.

Exemples

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 que le fichier doit être supprimé.

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)

Remarques

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

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

À	Consultez
Pour supprimer un fichier	Procédure : supprimer un fichier

Voir aussi

• RecycleOption
• UIOption
• Objets (Visual Basic)
• Guide pratique pour supprimer un fichier dans Visual Basic

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Supprime un fichier.

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Paramètres

file

String

Nom et chemin d'accès du fichier à supprimer.

showUI

UIOption

Indique si un suivi visuel de l'avancement de l'opération est nécessaire. La valeur par défaut est UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Indique si le fichier supprimé doit ou non être envoyé à la Corbeille. La valeur par défaut est RecycleOption.DeletePermanently.

onUserCancel

UICancelOption

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

Exceptions

ArgumentException

Le chemin d’accès n’est pas valide pour l’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 a une barre oblique de fin où un fichier doit être spécifié ; ou il s’agit d’un chemin d’appareil (commence par \\.\).

ArgumentNullException

file est soit Nothing soit une chaîne vide.

PathTooLongException

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

NotSupportedException

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

IOException

Le fichier est en cours d'utilisation.

SecurityException

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

FileNotFoundException

Le fichier n'existe pas.

UnauthorizedAccessException

L'utilisateur n'a pas l'autorisation nécessaire pour supprimer le fichier ou le fichier est en lecture seule.

OperationCanceledException

L'utilisateur a annulé l'opération et onUserCancel a la valeur ThrowException.

Exemples

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 que le fichier doit être supprimé.

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)

Remarques

Les showUIparamètres , recycleet onUserCancel ne sont pas pris en charge dans les applications qui ne sont pas interactives par l’utilisateur, telles que les services Windows.

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

À	Consultez
Pour supprimer un fichier	Procédure : supprimer un fichier

Voir aussi

• UICancelOption
• RecycleOption
• UIOption
• Objets (Visual Basic)
• Guide pratique pour supprimer un fichier dans Visual Basic