File.Exists(String) Methode

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

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.true 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 folgenden Beispiel wird ermittelt, 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 Pfad Validierung verwendet werden. diese Methode überprüft lediglich, ob die in path angegebene Datei vorhanden ist.The Exists method should not be used for path validation, this method merely checks if the file specified in path exists. Wenn ein ungültiger Pfad an Exists übergeben wird falsewird zurückgegeben.Passing an invalid path to Exists returns false. Um zu überprüfen, ob der Pfad ungültige Zeichen enthält, können Sie die GetInvalidPathChars-Methode aufrufen, um die ungültigen Zeichen für das Dateisystem abzurufen.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 einen regulären Ausdruck erstellen, um zu 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 akzeptable Pfade finden Sie unter File.For examples of acceptable paths, see File.

Informationen dazu, 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 in zwischen dem Zeitpunkt, an dem Sie die Exists-Methode aufzurufen, und dem Ausführen eines weiteren Vorgangs in der 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.

Der path-Parameter darf relative oder absolute Pfadinformationen angeben.The path parameter is permitted to specify relative or absolute path information. Relative Pfadinformationen werden als relativ zum aktuellen Arbeitsverzeichnis interpretiert.Relative path information is interpreted as relative to the current working directory. Informationen zum Abrufen des aktuellen Arbeitsverzeichnisses finden Sie unter GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Wenn path ein Verzeichnis beschreibt, gibt diese Methode falsezurück.If path describes a directory, this method returns false. Nachfolgende Leerzeichen werden aus dem path-Parameter entfernt, bevor bestimmt wird, ob die Datei vorhanden ist.Trailing spaces are removed from the path parameter before determining if the file exists.

Die Exists-Methode gibt false zurück, wenn bei dem Versuch, festzustellen, ob die angegebene Datei vorhanden ist, ein Fehler auftritt.The Exists method returns false if any error occurs while trying to determine if the specified file exists. Dies kann in Situationen auftreten, in denen Ausnahmen ausgelöst werden, z. b. das Übergeben eines Datei namens mit ungültigen Zeichen oder zu vielen Zeichen, einem fehlerhaften oder fehlenden Datenträger oder, wenn der Aufrufer nicht über die Berechtigung zum Lesen der Datei verfügt.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. Zugehörige Enumeration: ReadAssociated enumeration: Read

Gilt für:

Siehe auch