FileSystemProxy.GetFiles メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetFiles(String, SearchOption, String[]) |
ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。 |
| GetFiles(String) |
ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。 |
GetFiles(String, SearchOption, String[])
ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。
public:
System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles(string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)
パラメーター
- directory
- String
検索するディレクトリ。
- searchType
- SearchOption
サブフォルダーを含めるかどうか。 既定値は SearchOption.SearchTopLevelOnly です。
- wildcards
- String[]
一致するパターン。
返品
指定したディレクトリからのファイル名の読み取り専用コレクション。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。
directory は Nothingです。
検索するディレクトリが存在しません。
directory は既存のファイルを指します。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
ユーザーに必要なアクセス許可がありません。
例
次の例では、ディレクトリ内のすべてのファイルを返し、 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 メソッドに関連するタスクの例を示します。
| ターゲット | 参照先 |
|---|---|
| ディレクトリ内のファイルのコレクションを取得する | 方法: ディレクトリ内のファイルのコレクションを取得する |
| ディレクトリ内の特定のパターンを持つファイルを検索する | 方法: 特定のパターンのファイルを検索する |
こちらもご覧ください
- SearchOption
- ReadOnlyCollection<T>
- オブジェクト (Visual Basic)
方法: Visual Basic 方法: Visual Basic
適用対象
GetFiles(String)
ディレクトリ内のファイル名を表す文字列の読み取り専用コレクションを返します。
public:
System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles(string directory);
member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String) As ReadOnlyCollection(Of String)
パラメーター
- directory
- String
検索するディレクトリ。
返品
指定したディレクトリからのファイル名の読み取り専用コレクション。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。
directory は Nothingです。
検索するディレクトリが存在しません。
directory は既存のファイルを指します。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
ユーザーに必要なアクセス許可がありません。
例
次の例では、ディレクトリ内のすべてのファイルを返し、 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 メソッドに関連するタスクの例を示します。
| ターゲット | 参照先 |
|---|---|
| ディレクトリ内のファイルのコレクションを取得する | 方法: ディレクトリ内のファイルのコレクションを取得する |
| ディレクトリ内の特定のパターンを持つファイルを検索する | 方法: 特定のパターンのファイルを検索する |
こちらもご覧ください
- ReadOnlyCollection<T>
- オブジェクト (Visual Basic)
方法: Visual Basic 方法: Visual Basic