File.Exists(String) Methode
Definition
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
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 path
null
, 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 path
false
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 false
zurü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 false
zurü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.