File.Exists(String) File.Exists(String) File.Exists(String) File.Exists(String) Method

Definition

Bestimmt, ob die angegebene Datei vorhanden ist.Determines whether the specified file exists.

public:
 static bool Exists(System::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 String String String

Die zu überprüfende Datei.The file to check.

Gibt zurück

true wenn der Aufrufer über die erforderlichen Berechtigungen verfügt und path den Namen einer vorhandenen Datei enthält, andernfalls false.if the caller has the required permissions and path contains the name of an existing file; otherwise, false. Diese Methode gibt auch false zurück, wenn für pathnull, ein ungültiger Pfad oder eine Zeichenfolge der Länge 0 (null) festgelegt ist.This method also returns false if path is null, an invalid path, or a zero-length string. Wenn ein Aufrufer nicht über ausreichende Berechtigungen zum Lesen der angegebenen Datei verfügt, wird keine Ausnahme ausgelöst, und die Methode gibt false zurück, unabhängig vom Vorhandensein von path.If the caller does not have sufficient permissions to read the specified file, no exception is thrown and the method returns false regardless of the existence of path.

Beispiele

Im folgende Beispiel wird bestimmt, ob eine Datei vorhanden ist.The following example determines if a file exists.

string curFile = @"c:\temp\test.txt";
Console.WriteLine(File.Exists(curFile) ? "File exists." : "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

Die Exists Methode sollte nicht für die Überprüfung des Pfads verwendet werden, diese Methode überprüft nur, wenn in der Datei angegeben path vorhanden ist.The Exists method should not be used for path validation, this method merely checks if the file specified in path exists. Übergeben einen ungültigen Pfad zur Exists gibt false.Passing an invalid path to Exists returns false. Um zu überprüfen, ob der Pfad auf ungültigen Zeichen enthält, rufen Sie die GetInvalidPathChars Methode, um die Zeichen abzurufen, die für das Dateisystem ungültig sind.To check whether the path contains any invalid characters, you can call the GetInvalidPathChars method to retrieve the characters that are invalid for the file system. Sie können auch erstellen, einen regulären Ausdruck zum Testen, ob der Pfad für Ihre Umgebung gültig ist.You can also create a regular expression to test the whether the path is valid for your environment. Beispiele für Pfade zulässig, finden Sie unter File.For examples of acceptable paths, see File.

Um festzustellen, ob ein Verzeichnis vorhanden ist, finden Sie unter Directory.Exists.To check if a directory exists, see Directory.Exists.

Beachten Sie, dass ein anderer Prozess möglicherweise etwas mit der Datei zwischen der Zeit können Sie aufrufen, werden die Exists Methode und führen Sie einen anderen Vorgang für die Datei, z. B. Delete.Be aware that another process can potentially do something with the file in between the time you call the Exists method and perform another operation on the file, such as Delete.

Die path Parameter dürfen relativer oder absoluter Pfad angegeben werden.The path parameter is permitted to specify relative or absolute path information. Relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis interpretiert.Relative path information is interpreted as relative to the current working directory. Um das aktuelle Arbeitsverzeichnis zu erhalten, finden Sie unter GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Wenn path wird beschrieben, ein Verzeichnis, gibt diese Methode false.If path describes a directory, this method returns false. Nachgestellte Leerzeichen entfernt sind die path -Parameter vor dem ermitteln, ob die Datei vorhanden ist.Trailing spaces are removed from the path parameter before determining if the file exists.

Die Exists Methodenrückgabe false Wenn ein Fehler auftritt, bei dem Versuch, um festzustellen, ob die angegebene Datei vorhanden ist.The Exists method returns false if any error occurs while trying to determine if the specified file exists. Dies kann auftreten, in Situationen, in denen Auslösen von Ausnahmen, z. B. ein Dateiname ungültige Zeichen oder zu viele Zeichen, eine fehlerhafte oder fehlende Datenträger übergeben oder wenn der Aufrufer keine Berechtigung zum Lesen der Datei.This can occur in situations that raise exceptions such as passing a file name with invalid characters or too many characters, a failing or missing disk, or if the caller does not have permission to read the file.

Sicherheit

FileIOPermission
zum Lesen aus der angegebenen Datei.for reading from the specified file. Zugeordnete Enumeration:Associated enumeration: Read

Gilt für:

Siehe auch