File.Exists(String) Méthode

Définition

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

Boolean

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.");
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 d’accès, cette méthode vérifie simplement si le fichier spécifié dans path existe. Passage d’un chemin d’accès non valide à Exists returns false . Pour vérifier si le chemin d’accès contient des caractères non valides, vous pouvez appeler la GetInvalidPathChars méthode pour récupérer les caractères qui ne sont pas 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 l’existence d’un répertoire, consultez Directory.Exists .

N’oubliez pas qu’un autre processus peut potentiellement faire un fichier entre le moment où vous appelez la Exists méthode et effectuer une autre opération sur le fichier, par exemple Delete .

Le path paramètre est autorisé à spécifier des informations relatives au chemin d’accès relatif ou absolu. Les informations relatives au chemin d’accès relatif sont interprétées par rapport 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 en tentant de déterminer si le fichier spécifié existe. Cela peut se produire dans les situations qui lèvent des exceptions, telles que la transmission 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’est pas autorisé à lire le fichier.

S’applique à

Voir aussi