File.Exists(String) Méthode

Définition

Détermine si le fichier spécifié existe.Determines whether the specified file exists.

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.The file to check.

Retours

true si l'appelant a les autorisations requises et si path contient le nom d'un fichier existant ; sinon, false.true if the caller has the required permissions and path contains the name of an existing file; otherwise, 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.This method also returns false if path is null, an invalid path, or a zero-length string. 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.If the caller does not have sufficient permissions to read the specified file, no exception is thrown and the method returns false regardless of the existence of path.

Exemples

L’exemple suivant détermine si un fichier existe.The following example determines if a file exists.

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 méthode Exists 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.The Exists method should not be used for path validation, this method merely checks if the file specified in path exists. Le passage d’un chemin d’accès non valide à Exists retourne false.Passing an invalid path to Exists returns false. Pour vérifier si le chemin d’accès contient des caractères non valides, vous pouvez appeler la méthode GetInvalidPathChars pour récupérer les caractères qui ne sont pas valides pour le système de fichiers.To check whether the path contains any invalid characters, you can call the GetInvalidPathChars method to retrieve the characters that are invalid for the file system. Vous pouvez également créer une expression régulière pour tester si le chemin d’accès est valide pour votre environnement.You can also create a regular expression to test the whether the path is valid for your environment. Pour obtenir des exemples de chemins d’accès acceptables, consultez File.For examples of acceptable paths, see File.

Pour vérifier l’existence d’un répertoire, consultez Directory.Exists.To check if a directory exists, see Directory.Exists.

N’oubliez pas qu’un autre processus peut potentiellement faire un fichier entre le moment où vous appelez la méthode Exists et effectuer une autre opération sur le fichier, comme Delete.Be aware that another process can potentially do something with the file in between the time you call the Exists method and perform another operation on the file, such as Delete.

Le paramètre path est autorisé à spécifier des informations sur le chemin d’accès relatif ou absolu.The path parameter is permitted to specify relative or absolute path information. Les informations relatives au chemin d’accès relatif sont interprétées par rapport au répertoire de travail actuel.Relative path information is interpreted as relative to the current working directory. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Si path décrit un répertoire, cette méthode retourne false.If path describes a directory, this method returns false. Les espaces de fin sont supprimés du paramètre path avant de déterminer si le fichier existe.Trailing spaces are removed from the path parameter before determining if the file exists.

La méthode Exists retourne false si une erreur se produit en tentant de déterminer si le fichier spécifié existe.The Exists method returns false if any error occurs while trying to determine if the specified file exists. 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.This can occur in situations that raise exceptions such as passing a file name with invalid characters or too many characters, a failing or missing disk, or if the caller does not have permission to read the file.

Sécurité

FileIOPermission
pour la lecture à partir du fichier spécifié.for reading from the specified file. Énumération associée : ReadAssociated enumeration: Read

S’applique à

Voir aussi