File.Exists(String) Metoda

Definice

Určuje, zda zadaný soubor existuje.

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

Parametry

path
String

Soubor, který chcete ověřit.

Návraty

Boolean

true Pokud má volající požadovaná oprávnění a path obsahuje název existujícího souboru, v opačném případě false . Tato metoda také vrátí false path , pokud 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.");
Dim curFile As String = "c:\temp\test.txt"
Console.WriteLine(If(File.Exists(curFile), "File exists.", "File does not exist."))

Poznámky

ExistsMetoda by neměla být použita pro ověření cesty, tato metoda pouze kontroluje, zda soubor zadaný v souboru path existuje. Předání neplatné cesty k Exists vrácení false . Chcete-li ověřit, zda cesta obsahuje neplatné znaky, můžete zavolat GetInvalidPathChars metodu pro načtení znaků, které jsou pro systém souborů neplatné. Můžete také vytvořit regulární výraz pro otestování, jestli je cesta pro vaše prostředí platná. Příklady přijatelných cest naleznete 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 s souborem pracovat v době mezi voláním Exists metody a provedením jiné operace se souborem, jako je například Delete .

pathParametr je povolen pro zadání relativní nebo absolutní informace o cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Chcete-li získat aktuální pracovní adresář, přečtěte si téma GetCurrentDirectory .

Pokud path popisuje adresář, vrátí tato metoda false . pathPřed zjištěním, zda soubor existuje, jsou koncové mezery odebrány z parametru.

ExistsMetoda se vrátí, false Pokud dojde k chybě při pokusu o zjištění, zda zadaný soubor existuje. K tomu může dojít v situacích, které vyvolávají výjimky, jako je například předávání názvu souboru s neplatnými znaky nebo příliš mnoho znaků, neúspěšného nebo chybějícího disku, nebo pokud volající nemá oprávnění ke čtení tohoto souboru.

Platí pro

Viz také