File.Exists(String) Méthode

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

Retours

true si l'appelant a les autorisations requises et si 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 n'a pas les 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

La Exists méthode ne doit pas être utilisée pour la validation de chemin, cette méthode vérifie simplement si le fichier spécifié dans path existe. La transmission 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 GetInvalidPathChars méthode 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 d’accès 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 Exists méthode et que vous effectuez une autre opération sur le fichier, telle que Delete.

Le path paramètre 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 path paramètre avant de déterminer si le fichier existe.

La Exists méthode 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 un trop grand nombre de caractères, un disque défaillant ou manquant, ou si l’appelant n’a pas l’autorisation de lire le fichier.

S’applique à

Voir aussi

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