File.Exists(String) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

File.cs

Určuje, zda zadaný soubor existuje.

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

Parametry

path

String

Soubor, který chcete zkontrolovat.

Návraty

Boolean

truepokud má volající požadovaná oprávnění a path obsahuje název existujícího souboru, jinak . false Tato metoda také vrátí false , pokud path je null, neplatná cesta nebo řetězec nulové délky. Pokud volající nemá dostatečná oprávnění ke čtení zadaného souboru, není vyvolána žádná výjimka a metoda vrátí false bez ohledu na existenci path.

Příklady

Následující příklad určuje, zda soubor existuje.

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

Poznámky

Nepoužívejte metodu Exists pro ověření cesty. Tato metoda pouze zkontroluje, jestli soubor zadaný v path souboru existuje. Předání neplatné cesty k Exists vrácení false. Chcete-li zkontrolovat, zda cesta obsahuje neplatné znaky, můžete volat metodu GetInvalidPathChars pro načtení znaků, které jsou neplatné pro systém souborů. Můžete také vytvořit regulární výraz, který otestuje, jestli je cesta pro vaše prostředí platná. Příklady přijatelných cest najdete v tématu File.

Pokud chcete zjistit, jestli adresář existuje, přečtěte si téma Directory.Exists.

Mějte na paměti, že jiný proces může potenciálně udělat něco se souborem v době, kdy voláte metodu Exists , a provést jinou operaci se souborem, například Delete.

Parametr path má povoleno zadat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři. Aktuální pracovní adresář získáte v tématu GetCurrentDirectory.

Pokud path popisuje adresář, tato metoda vrátí false. Koncové mezery se z parametru path odeberou před určením, jestli soubor existuje.

Metoda Exists vrátí false , pokud dojde k nějaké chybě při pokusu zjistit, zda zadaný soubor existuje. K tomu může dojít v situacích, kdy vyvoláte výjimky, jako je předání názvu souboru s neplatnými znaky nebo příliš mnoho znaků, selhání nebo chybějící disk nebo pokud volající nemá oprávnění ke čtení souboru.

Viz také

• Exists(String)
• Vstup/výstup souborů a streamů
• Čtení textu ze souboru
• Postupy: Zápis textu do souboru