Udostępnij za pośrednictwem

File.Exists(String) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestawy:
mscorlib.dll, System.IO.FileSystem.dll
Zestaw:
System.IO.FileSystem.dll
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Określa, czy określony plik istnieje.

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

Plik do sprawdzenia.

Zwraca

Boolean

true, jeśli obiekt wywołujący ma wymagane uprawnienia, a path zawiera nazwę istniejącego pliku; w przeciwnym razie false. Ta metoda zwraca również false, jeśli path jest null, nieprawidłową ścieżką lub ciągiem o zerowej długości. Jeśli obiekt wywołujący nie ma wystarczających uprawnień do odczytu określonego pliku, nie jest zgłaszany żaden wyjątek, a metoda zwraca false niezależnie od istnienia path.

Przykłady

Poniższy przykład określa, czy plik istnieje.

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

Uwagi

Nie używaj metody Exists do sprawdzania poprawności ścieżki; ta metoda sprawdza tylko, czy plik określony w path istnieje. Przekazanie nieprawidłowej ścieżki do Exists zwraca false. Aby sprawdzić, czy ścieżka zawiera nieprawidłowe znaki, możesz wywołać metodę GetInvalidPathChars, aby pobrać nieprawidłowe znaki dla systemu plików. Możesz również utworzyć wyrażenie regularne, aby sprawdzić, czy ścieżka jest prawidłowa dla danego środowiska. Aby zapoznać się z przykładami akceptowalnych ścieżek, zobacz File.

Aby sprawdzić, czy katalog istnieje, zobacz Directory.Exists.

Należy pamiętać, że inny proces może potencjalnie wykonać coś z plikiem między wywołaniem metody Exists i wykonać inną operację na pliku, taką jak Delete.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Jeśli path opisuje katalog, ta metoda zwraca false. Spacje końcowe są usuwane z parametru path przed ustaleniem, czy plik istnieje.

Metoda Exists zwraca false, jeśli wystąpi jakikolwiek błąd podczas próby ustalenia, czy określony plik istnieje. Może to wystąpić w sytuacjach, które zgłaszają wyjątki, takie jak przekazywanie nazwy pliku z nieprawidłowymi znakami lub zbyt wiele znaków, awaria lub brak dysku lub jeśli obiekt wywołujący nie ma uprawnień do odczytu pliku.

Dotyczy

Zobacz też