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
, если path
null
, недопустимый путь или строка нулевой длины. Если вызывающий объект не имеет достаточных разрешений для чтения указанного файла, исключение не возникает, а метод возвращает 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
, если возникает ошибка при попытке определить, существует ли указанный файл. Это может произойти в ситуациях, которые вызывают исключения, такие как передача имени файла с недопустимыми символами или слишком большим количеством символов, сбой или отсутствующий диск, или если вызывающий объект не имеет разрешения на чтение файла.