File.Exists(String) File.Exists(String) File.Exists(String) File.Exists(String) Method

Определение

Определяет, существует ли заданный файл.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

Параметры

path
String String String String

Проверяемый файл.The file to check.

Возвраты

Значение true, если вызывающий оператор имеет требуемые разрешения и path содержит имя существующего файла; в противном случае — false.true if the caller has the required permissions and path contains the name of an existing file; otherwise, false. Этот метод также возвращает false, если pathnull, недействительный путь или строка нулевой длины.This method also returns false if path is null, an invalid path, or a zero-length string. Если у вызывающего оператора нет достаточных полномочий на чтение заданного файла, исключения не создаются, а данный метод возвращает false вне зависимости от существования 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.

Примеры

В следующем примере определяется, существует ли файл.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."))

Комментарии

Метод не должен использоваться для проверки пути. Этот метод просто проверяет, существует ли файл, указанный в path EXISTS. ExistsThe Exists method should not be used for path validation, this method merely checks if the file specified in path exists. Передача недопустимого пути для Exists возврата false.Passing an invalid path to Exists returns false. Чтобы проверить, содержит ли путь недопустимые символы, можно вызвать GetInvalidPathChars метод, чтобы получить символы, недопустимые для файловой системы.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. Можно также создать регулярное выражение для проверки того, является ли путь допустимым для вашей среды.You can also create a regular expression to test the whether the path is valid for your environment. Примеры допустимых путей см. в Fileразделе.For examples of acceptable paths, see File.

Чтобы проверить, существует ли каталог, см Directory.Exists. раздел.To check if a directory exists, see Directory.Exists.

Имейте в виду, что другой процесс потенциально может сделать что-то с файлом в промежутке между Exists вызовом метода и выполнением другой операции с файлом, 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.

path Параметр может указывать сведения относительного или абсолютного пути.The path parameter is permitted to specify relative or absolute path information. Сведения об относительном пути интерпретируется как относительно текущего рабочего каталога.Relative path information is interpreted as relative to the current working directory. Сведения о получении текущего рабочего каталога см. GetCurrentDirectoryв разделе.To obtain the current working directory, see GetCurrentDirectory.

Если path описывает каталог, этот метод возвращает false.If path describes a directory, this method returns false. Конечные пробелы удаляются из path параметра перед определением наличия файла.Trailing spaces are removed from the path parameter before determining if the file exists.

Метод Exists возвращаетfalse значение, если возникла ошибка при попытке определить, существует ли указанный файл.The Exists method returns false if any error occurs while trying to determine if the specified file exists. Это может произойти в ситуациях, когда вызываются такие исключения, как передача имени файла с недопустимыми символами или слишком много символов, неудачный или отсутствующий диск или если вызывающий объект не имеет разрешения на чтение файла.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.

Безопасность

FileIOPermission
для чтения из указанного файла.for reading from the specified file. Связанное перечисление:ReadAssociated enumeration: Read

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

Дополнительно