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, falsejinak . 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, jestli 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

Metoda Exists by neměla být používána k ověření cesty, tato metoda pouze kontroluje, zda soubor zadaný v path souboru existuje. Předání neplatné cesty vrátí Existsfalsehodnotu . Chcete-li zkontrolovat, zda cesta obsahuje nějaké neplatné znaky, můžete voláním GetInvalidPathChars metody načíst znaky, které jsou neplatné pro systém souborů. Můžete také vytvořit regulární výraz, který otestuje, jestli je cesta platná pro vaše prostředí. Příklady přijatelných cest najdete v tématu File.

Pokud chcete zkontrolovat, jestli adresář existuje, projděte si téma Directory.Exists.

Mějte na paměti, že mezi voláním Exists metody a provedením další operace se souborem může provést jiný proces, například Delete.

Parametr path může zadat relativní nebo absolutní informace o cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Pokud chcete získat aktuální pracovní adresář, přečtěte si téma GetCurrentDirectory.

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

Metoda Exists vrátí false , pokud dojde k nějaké 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 předání názvu souboru s neplatnými znaky nebo příliš mnoha znaků, selhání nebo chybějící disk nebo pokud volající nemá oprávnění ke čtení souboru.

Viz také

• Exists(String)
• Vstupně-výstupní operace souborů a Stream
• Čtení textu ze souboru
• Postupy: Zápis textu do souboru