File.Exists(String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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 .
path
Parametr 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
. path
Př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.