File.Exists(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
true jeśli obiekt wywołujący ma wymagane uprawnienia i path zawiera nazwę istniejącego pliku; w przeciwnym razie false. Ta metoda zwraca false również wartość , jeśli path jest nullto , nieprawidłowa ścieżka lub ciąg 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 wyjątek, a metoda zwraca false niezależnie od istnienia pathklasy .
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 do sprawdzania Exists poprawności ścieżki. Ta metoda sprawdza tylko, czy plik określony w path pliku istnieje. Przekazanie nieprawidłowej ścieżki do Exists zwraca wartość 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. Przykłady akceptowalnych ścieżek można znaleźć w temacie 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 Exists metody i wykonać inną operację w 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 opisano katalog, ta metoda zwraca wartość 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.