FileSystem.GetFiles メソッド

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.Core.dll

ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。

オーバーロード

GetFiles(String)	ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。
GetFiles(String, SearchOption, String[])	ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。

GetFiles(String)

ソース:

FileSystem.vb

ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);

static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

パラメーター

directory

String

検索するディレクトリ。

戻り値

ReadOnlyCollection<String>

指定されたディレクトリから取得されたファイル名の読み取り専用コレクション。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。

ArgumentNullException

directory が Nothingです。

DirectoryNotFoundException

検索対象のディレクトリが存在しません。

IOException

directory が既存のファイルを指しています。

PathTooLongException

パスがシステム定義の最大長を超えています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。

SecurityException

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

UnauthorizedAccessException

ユーザーに必要なアクセス許可がありません。

例

次の例では、ディレクトリ内のすべてのファイルが返され、ListBox1 に追加されます。

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

この例では、フォームに という名前ListBox1がListBox付けられている必要があります。

次の使用例は、 ディレクトリ内のすべてのファイルを 拡張子 .txt を持つ を返し、 に ListBox1追加します。

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

この例では、フォームに という名前ListBox1がListBox付けられている必要があります。

注釈

指定したパターンに一致するファイルがない場合は、空のコレクションが返されます。

次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.GetFiles 示します。

終了	解決方法については、
ディレクトリ内のファイルのコレクションを取得する	方法: Visual Basic でディレクトリにあるファイルのコレクションを取得する
ディレクトリ内の特定のパターンを持つファイルを検索する	方法: 特定のパターンに一致するファイルを検索する (Visual Basic)

こちらもご覧ください

• ReadOnlyCollection<T>

GetFiles(String, SearchOption, String[])

ソース:

FileSystem.vb

ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

パラメーター

directory

String

検索するディレクトリ。

searchType

SearchOption

サブフォルダーを含めるかどうか。 既定値は SearchOption.SearchTopLevelOnly です。

wildcards

String[]

検索に使用するパターン。

戻り値

ReadOnlyCollection<String>

指定されたディレクトリから取得されたファイル名の読み取り専用コレクション。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。

ArgumentNullException

directory が Nothingです。

DirectoryNotFoundException

検索対象のディレクトリが存在しません。

IOException

directory が既存のファイルを指しています。

PathTooLongException

パスがシステム定義の最大長を超えています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。

SecurityException

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

UnauthorizedAccessException

ユーザーに必要なアクセス許可がありません。

例

次の例では、ディレクトリ内のすべてのファイルが返され、ListBox1 に追加されます。

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

この例では、フォームに という名前ListBox1がListBox付けられている必要があります。

次の使用例は、 ディレクトリ内のすべてのファイルを 拡張子 .txt を持つ を返し、 に ListBox1追加します。

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

この例では、フォームに という名前ListBox1がListBox付けられている必要があります。

注釈

指定したパターンに一致するファイルがない場合は、空のコレクションが返されます。

次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.GetFiles 示します。

終了	解決方法については、
ディレクトリ内のファイルのコレクションを取得する	方法: Visual Basic でディレクトリにあるファイルのコレクションを取得する
ディレクトリ内の特定のパターンを持つファイルを検索する	方法: 特定のパターンに一致するファイルを検索する (Visual Basic)

こちらもご覧ください

• SearchOption
• ReadOnlyCollection<T>