File.Exists(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したファイルが存在するかどうかを判断します。
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
確認するファイル。
返品
true 呼び出し元に必要なアクセス許可があり、 path に既存のファイルの名前が含まれている場合は a0/>。それ以外の場合は false。 このメソッドは、falseがpath、無効なパス、または長さ 0 の文字列である場合にも、nullを返します。 呼び出し元に指定されたファイルを読み取る十分なアクセス許可がない場合、例外はスローされず、メソッドは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を返します。 これは、無効な文字または文字が多すぎるファイル名の渡し、ディスクの障害または不足、呼び出し元にファイルの読み取りアクセス許可がないなどの例外が発生する場合に発生する可能性があります。