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

truejeś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 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

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 metody 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 dopuszczalnych ścieżek można znaleźć w temacie File.

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

Należy pamiętać, że inny proces może potencjalnie wykonać operację z plikiem między czasem wywołania Exists metody 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ę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 ustaleniem, czy plik istnieje.

Metoda Exists zwraca false wartość , jeśli wystąpi jakikolwiek błąd podczas próby ustalenia, czy określony plik istnieje. Taka sytuacja może wystąpić w sytuacjach, w których występują 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