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

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

Boolean

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 żaden wyjątek, a metoda zwraca false wartość niezależnie od istnienia pathelementu .

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

Metoda nie powinna być używana do sprawdzania poprawności ścieżki. Ta Exists metoda sprawdza tylko, czy plik określony w path pliku istnieje. Przekazanie nieprawidłowej ścieżki do Exists zwracania falsewartości . Aby sprawdzić, czy ścieżka zawiera nieprawidłowe znaki, możesz wywołać GetInvalidPathChars metodę , aby pobrać znaki, które są nieprawidłowe 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 dopuszczalnych ścieżek, zobacz File.

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

Należy pamiętać, że inny proces może potencjalnie zrobić coś z plikiem między wywołaniem Exists metody i wykonać inną operację w pliku, na przykład 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ędne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

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

Metoda Exists zwraca false , jeśli wystąpi jakikolwiek błąd podczas próby określenia, 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, niepowodzenie lub brak dysku lub jeśli obiekt wywołujący nie ma uprawnień do odczytu pliku.

Dotyczy