File.Exists(String) Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

File.cs

Détermine si le fichier spécifié existe.

public:
 static bool Exists(System::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

Boolean

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.

Voir aussi

• Exists(String)
• fichier et flux d’E/S
• lecture de texte à partir d’un fichier
• Comment : écrire du texte dans un fichier