更新 : 2007 年 11 月
指定したディレクトリの中から、指定した検索パターンに一致し、サブディレクトリを検索するかどうかを決定する値を持つファイル名を返します。
(mscorlib.dll 内)
Public Shared Function GetFiles ( _
path As String, _
searchPattern As String, _
searchOption As SearchOption _
) As String()
Dim path As String
Dim searchPattern As String
Dim searchOption As SearchOption
Dim returnValue As String()
returnValue = Directory.GetFiles(path, _
searchPattern, searchOption)
public static string[] GetFiles(
string path,
string searchPattern,
SearchOption searchOption
)
public:
static array<String^>^ GetFiles(
String^ path,
String^ searchPattern,
SearchOption searchOption
)
public static String[] GetFiles(
String path,
String searchPattern,
SearchOption searchOption
)
public static function GetFiles(
path : String,
searchPattern : String,
searchOption : SearchOption
) : String[]
戻り値
型 :
array<System..::.String>[]()[]指定したディレクトリ内の指定した検索パターンに一致するファイル名を格納する String 配列。ファイル名には完全パスが含まれます。
ファイル名には完全パスが含まれます。
ファイルが存在しない場合、または searchPattern パラメータに一致するファイルがない場合、このメソッドは空の配列を返します。
返されるファイル名の順序は保証されません。特定の並べ替え順序が必要な場合は、Sort()()() メソッドを使用します。
searchPattern パラメータで許可されるワイルドカード指定子を次に示します。
ワイルドカード文字 | 説明 |
|---|
* | 0 個以上の文字。 |
? | 0 文字または 1 文字。 |
ワイルドカード指定子以外の文字は、その文字自体を表します。たとえば、searchPattern 文字列 "*t" は、 path パラメータ内で、文字 "t" で終わるすべての名前を検索します。searchPattern 文字列 "s*" は、path 内で、文字 "s" で始まるすべての名前を検索します。
.gif) メモ : |
|---|
searchPattern で "*.txt" などのアスタリスクのワイルドカード文字を使用した場合、拡張子の長さがちょうど 3 文字の場合と 3 文字以外の場合では、一致の仕方が変わります。searchPattern にちょうど 3 文字の拡張子が指定されていると、searchPattern に指定されている拡張子と最初の 3 文字が一致していて、3 文字以上の拡張子を持つファイルが返されます。searchPattern に 1 文字、2 文字、または 4 文字以上の拡張子が指定されていると、searchPattern に指定されている拡張子と一致していて、それと同じ長さの拡張子を持つファイルのみが返されます。疑問符のワイルドカード文字を使用した場合、このメソッドは、指定された拡張子と一致するファイルのみを返します。たとえば、ディレクトリ内に "file1.txt" と "file1.txtother" という 2 つのファイルが存在する場合、"file?.txt" という検索パターンでは 1 つ目のファイルのみが返されますが、"file*.txt" の検索パターンでは両方のファイルが返されます。 |
searchPattern パラメータにさまざまな長さが設定された場合の動作を次のリストに示します。
"*.abc" の場合、拡張子が .abc、.abcd、.abcde、.abcdef などになるファイルが返されます。
"*.abcd" の場合、拡張子が .abcd のファイルだけが返されます。
"*.abcde" の場合、拡張子が .abcde のファイルだけが返されます。
"*.abcdef" の場合、拡張子が .abcdef のファイルだけが返されます。
| メモ : |
|---|
このメソッドは、8.3 形式のファイル名と長いファイル名の両方の形式を使用してファイル名をチェックするため、"*1*.txt" に類似した検索パターンを使用すると予期しないファイル名が返されることがあります。たとえば、"*1*.txt" という検索パターンを使用すると "longfilename.txt" が返されます。その理由は、このファイル名は 8.3 形式のファイル名で "LONGFI~1.TXT" となるためです。 |
path パラメータは、相対パス情報または絶対パス情報を指定することを許可されています。相対パス情報は、現在の作業ディレクトリに対して相対的に解釈されます。現在の作業ディレクトリを取得するには、GetCurrentDirectory のトピックを参照してください。
path パラメータでは大文字と小文字が区別されません。
共通 I/O タスクの一覧については、「共通 I/O タスク」を参照してください。
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
.NET Framework
サポート対象 : 3.5、3.0、2.0
参照
その他の技術情報