Partager via


FileSystemProxy.DeleteFile Méthode

Définition

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

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

file est soit Nothing soit une chaîne vide.

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

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

Le fichier est en cours d'utilisation.

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

Le fichier n'existe pas.

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

S’applique à

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

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

file est soit Nothing soit une chaîne vide.

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

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

Le fichier est en cours d'utilisation.

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

Le fichier n'existe pas.

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

S’applique à

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

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

file est soit Nothing soit une chaîne vide.

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

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

Le fichier est en cours d'utilisation.

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

Le fichier n'existe pas.

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

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

S’applique à