File.Exists(String) Methode

Referenz

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bestimmt, ob die angegebene Datei vorhanden ist.

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

Parameter

path: String

Die zu überprüfende Datei.

Gibt zurück

Boolean

true, wenn der Aufrufer über die erforderlichen Berechtigungen verfügt und path den Namen einer vorhandenen Datei enthält; andernfalls false. Diese Methode gibt auch false zurück, wenn pathnull, einen ungültigen Pfad oder eine leere Zeichenfolge ist. Wenn der Aufrufer nicht über ausreichende Berechtigungen zum Lesen der angegebenen Datei verfügt, wird keine Ausnahme ausgelöst, und die Methode gibt unabhängig vom Vorhandensein von pathfalse zurück.

Beispiele

Im folgenden Beispiel wird ermittelt, ob eine Datei vorhanden ist.

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

Hinweise

Verwenden Sie die Exists Methode nicht für die Pfadüberprüfung; Diese Methode überprüft lediglich, ob die in path angegebene Datei vorhanden ist. Das Übergeben eines ungültigen Pfads zu Exists gibt falsezurück. Um zu überprüfen, ob der Pfad ungültige Zeichen enthält, können Sie die GetInvalidPathChars-Methode aufrufen, um die für das Dateisystem ungültigen Zeichen abzurufen. Sie können auch einen regulären Ausdruck erstellen, um zu testen, ob der Pfad für Ihre Umgebung gültig ist. Beispiele für akzeptable Pfade finden Sie unter File.

Informationen zum Überprüfen, ob ein Verzeichnis vorhanden ist, finden Sie unter Directory.Exists.

Beachten Sie, dass ein anderer Prozess zwischen dem Aufrufen der Exists-Methode und dem Ausführen eines weiteren Vorgangs für die Datei, z. B. Delete, möglicherweise eine Aktion mit der Datei ausführen kann.

Der path-Parameter darf relative oder absolute Pfadinformationen angeben. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.

Wenn path ein Verzeichnis beschreibt, gibt diese Methode falsezurück. Nachfolgende Leerzeichen werden aus dem parameter path entfernt, bevor ermittelt wird, ob die Datei vorhanden ist.

Die Exists-Methode gibt false zurück, wenn beim Versuch, festzustellen, ob die angegebene Datei vorhanden ist, ein Fehler auftritt. Dies kann in Situationen auftreten, in denen Ausnahmen ausgelöst werden, z. B. das Übergeben eines Dateinamens mit ungültigen Zeichen oder zu viele Zeichen, ein Fehler oder ein fehlender Datenträger oder wenn der Aufrufer nicht über die Berechtigung zum Lesen der Datei verfügt.

Gilt für:

Freigeben über