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
, если возникает какая-либо ошибка при попытке определить, существует ли указанный файл. Это может произойти в ситуациях, когда возникают исключения, такие как передача имени файла с недопустимыми символами или слишком большим количеством символов, сбой или отсутствие диска или если вызывающий объект не имеет разрешения на чтение файла.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по