File.Exists(String) Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Исходный код:

File.cs

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

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

Параметры

path

String

Файл для проверки.

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

Boolean

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

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

• Exists(String)
• файлов и потоковой ввода-вывода
• чтение текста из файла
• Практическое руководство. Запись текста в файл