方法: 特定のパターンに一致するファイルを検索する (Visual Basic)

2011-08-15

GetFiles メソッドは、ファイルのパス名を表す文字列の読み取り専用のコレクションを返します。 wildCards パラメーターを使用して、特定のパターンを指定できます。サブディレクトリを検索対象に含めるには、searchType パラメーターを SearchOption.SearchAllSubDirectories に設定します。

指定したパターンに一致するファイルが見つからなかった場合は、空のコレクションが戻ります。

注意

System.IO 名前空間の DirectoryInfo クラスを使用してファイルの一覧を返す方法については、「GetFiles(String, SearchOption)」および「方法 : ディレクトリ一覧を作成する」を参照してください。

特定のパターンに一致するファイルを検索するには

GetFiles メソッドを使用して、検索するディレクトリの名前とパス、およびパターンを指定します。次の例では、拡張子が .dll のすべてのファイルをディレクトリ内から取得し、ListBox1 に追加します。
```
For Each foundFile As String In My.Computer.FileSystem.GetFiles(
    My.Computer.FileSystem.SpecialDirectories.MyDocuments,
    Microsoft.VisualBasic.FileIO.SearchOption.SearchAllSubDirectories, "*.dll")

    Listbox1.Items.Add(foundFile)
Next
```

セキュリティ

次の条件を満たす場合は、例外が発生する可能性があります。

パスは次の理由の 1 つが無効です。長さ 0 の文字列は、空白だけが含まれている、無効な文字が含まれていますまたはそれがデバイスパスである (始まる \\ です。 \) (ArgumentException).
パスが Nothing であるため、有効でない (ArgumentNullException)。
directory が存在しない (DirectoryNotFoundException)。
directory は既存のファイルである (IOException)。
パスがシステムで定義されている最大長を越えている (PathTooLongException)。
パス内のファイル名またはフォルダー名にコロン (:) が含まれているか、または形式が無効である (NotSupportedException)。
ユーザーがパスを参照するのに必要なアクセス許可がない (SecurityException)。
ユーザーに必要なアクセス許可がない (UnauthorizedAccessException)。