File.Exists(String) Метод

Определение

Определяет, существует ли заданный файл.

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

Параметры

path
String

Проверяемый файл.

Возвращаемое значение

Значение true, если вызывающий оператор имеет требуемые разрешения и path содержит имя существующего файла; в противном случае — false. Этот метод также возвращает false, если pathnull, недействительный путь или строка нулевой длины. Если у вызывающего оператора нет достаточных полномочий на чтение заданного файла, исключения не создаются, а данный метод возвращает false вне зависимости от существования path.

Примеры

В следующем примере определяется, существует ли файл.

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."))

Комментарии

Метод Exists не следует использовать для проверки пути, он просто проверяет, существует ли файл, указанный в path . Передача недопустимого пути в возвращает Exists .false Чтобы проверить, содержит ли путь недопустимые символы, можно вызвать GetInvalidPathChars метод , чтобы получить недопустимые символы для файловой системы. Можно также создать регулярное выражение, чтобы проверить, является ли путь допустимым для вашей среды. Примеры допустимых путей см. в разделе File.

Сведения о том, существует ли каталог, см. в разделе Directory.Exists.

Имейте в виду, что другой процесс потенциально может выполнить что-то с файлом в период между вызовом Exists метода и выполнением другой операции с файлом, например Delete.

Параметр path может указывать относительные или абсолютные сведения о пути. Сведения об относительном пути интерпретируются как относительные относительно текущего рабочего каталога. Сведения о том, как получить текущий рабочий каталог, см. в разделе GetCurrentDirectory.

Если path описывает каталог, этот метод возвращает false. Конечные пробелы удаляются из path параметра, прежде чем определить, существует ли файл.

Метод Exists возвращает значение false , если возникает какая-либо ошибка при попытке определить, существует ли указанный файл. Это может произойти в ситуациях, в которых возникают исключения, такие как передача имени файла с недопустимыми символами или слишком много символов, сбой или отсутствие диска или если вызывающий объект не имеет разрешения на чтение файла.

Применяется к

См. также раздел