File.Exists(String) 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

File.cs

判斷指定的檔案是否存在。

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

參數

path

String

要檢查的檔案。

傳回

Boolean

true 如果呼叫端具有必要的許可權，且 path 包含現有檔案的名稱;否則，false。 如果 pathnull、無效的路徑或零長度字串，這個方法也會傳回 false。 如果呼叫端沒有足夠的許可權可讀取指定的檔案，則不會擲回任何例外狀況，而且方法會傳回 false，而不論 path是否存在。

範例

下列範例會判斷檔案是否存在。

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

備註

請勿使用 Exists 方法進行路徑驗證;這個方法只會檢查 path 中指定的檔案是否存在。 將無效的路徑傳遞至 Exists 會傳回 false。 若要檢查路徑是否包含任何無效的字元，您可以呼叫 GetInvalidPathChars 方法來擷取檔系統無效的字元。 您也可以建立正規表示式來測試路徑是否對您的環境有效。 如需可接受的路徑範例，請參閱 File。

若要檢查目錄是否存在，請參閱 Directory.Exists。

請注意，在您呼叫 Exists 方法，並在檔案上執行另一個作業，例如 Delete，另一個進程可能會在 中對檔案執行某些動作。

path 參數可以指定相對或絕對路徑資訊。 相對路徑資訊會解譯為相對於目前工作目錄。 若要取得目前的工作目錄，請參閱 GetCurrentDirectory。

如果 path 描述目錄，這個方法會傳回 false。 在判斷檔案是否存在之前，會先從 path 參數移除尾端空格。

Exists 方法會傳回 false 嘗試判斷指定的檔案是否存在時發生任何錯誤。 如果引發例外狀況，例如傳遞無效字元或字元過多的檔名、失敗或遺失的磁碟，或呼叫端沒有讀取檔案的許可權，則會發生此情況。

另請參閱

• Exists(String)
• 檔案和串流 I/O
• 從檔案 讀取文字
• 如何：將文字寫入檔案