File.Exists(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Détermine si le fichier spécifié existe.
public:
static bool Exists(System::String ^ path);
public static bool Exists (string path);
public static bool Exists (string? path);
static member Exists : string -> bool
Public Shared Function Exists (path As String) As Boolean
Paramètres
- path
- String
Fichier à vérifier.
Retours
true
si l’appelant dispose des autorisations requises et path
contient le nom d’un fichier existant ; sinon, false
. Cette méthode retourne également false
si path
est null
, un chemin d’accès non valide ou une chaîne de longueur nulle. Si l’appelant ne dispose pas des autorisations suffisantes pour lire le fichier spécifié, aucune exception n’est levée et la méthode retourne false
indépendamment de l’existence de path
.
Exemples
L’exemple suivant détermine si un fichier existe.
string curFile = @"c:\temp\test.txt";
Console.WriteLine(File.Exists(curFile) ? "File exists." : "File does not exist.");
let curFile = @"c:\temp\test.txt"
printfn
$"""{if File.Exists curFile then
"File exists."
else
"File does not exist."}"""
Dim curFile As String = "c:\temp\test.txt"
Console.WriteLine(If(File.Exists(curFile), "File exists.", "File does not exist."))
Remarques
N’utilisez pas la méthode Exists pour la validation du chemin d’accès ; cette méthode vérifie simplement si le fichier spécifié dans path
existe. Le passage d’un chemin d’accès non valide à Exists retourne false
. Pour vérifier si le chemin contient des caractères non valides, vous pouvez appeler la méthode GetInvalidPathChars pour récupérer les caractères non valides pour le système de fichiers. Vous pouvez également créer une expression régulière pour tester si le chemin d’accès est valide pour votre environnement. Pour obtenir des exemples de chemins acceptables, consultez File.
Pour vérifier si un répertoire existe, consultez Directory.Exists.
N’oubliez pas qu’un autre processus peut potentiellement faire quelque chose avec le fichier entre le moment où vous appelez la méthode Exists et effectuez une autre opération sur le fichier, par exemple Delete.
Le paramètre path
est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.
Si path
décrit un répertoire, cette méthode retourne false
. Les espaces de fin sont supprimés du paramètre path
avant de déterminer si le fichier existe.
La méthode Exists retourne false
si une erreur se produit lors de la tentative de déterminer si le fichier spécifié existe. Cela peut se produire dans des situations qui déclenchent des exceptions telles que le passage d’un nom de fichier avec des caractères non valides ou trop de caractères, un disque défaillant ou manquant, ou si l’appelant n’a pas l’autorisation de lire le fichier.