File.Exists(String) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

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

true, pokud 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 kontroluje, zda soubor zadaný v path existuje. Předání neplatné cesty k Exists vrátí false. Chcete-li zkontrolovat, zda cesta obsahuje neplatné znaky, můžete volat metodu GetInvalidPathChars pro načtení znaků, které jsou pro systém souborů neplatné. 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 zkontrolovat, jestli adresář existuje, přečtěte si Directory.Exists.

Mějte na paměti, že jiný proces může potenciálně provést něco se souborem v době, kdy voláte Exists metodu, a provést další 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 GetCurrentDirectory.

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

Metoda Exists vrátí false pokud dojde k nějaké chybě při pokusu o určení, 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)
• soubor a streamování vstupně-výstupních
• čtení textu ze souboru
• Postupy: Zápis textu do souboru