File.Exists(String) メソッド

定義

指定したファイルが存在するかどうかを判断します。

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

パラメーター

path
String

確認するファイル。

戻り値

呼び出し元に必要なアクセス許可があり、path に既存のファイルの名前が含まれている場合に true します。それ以外の場合は、falseします。 このメソッドは、pathnull、無効なパス、または長さ 0 の文字列である場合も、false を返します。 呼び出し元に指定されたファイルを読み取る十分なアクセス許可がない場合、例外はスローされず、メソッドは pathの存在に関係なく false を返します。

次の例では、ファイルが存在するかどうかを判断します。

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 を返します。 これは、無効な文字または文字が多すぎるファイル名の渡し、ディスクの障害または不足、呼び出し元にファイルの読み取りアクセス許可がないなどの例外が発生する場合に発生する可能性があります。

適用対象

こちらもご覧ください