FileSystem.FindInFiles メソッド

定義

指定されたテキストが格納されたファイル名を表す文字列の読み取り専用コレクションを返します。

オーバーロード

FindInFiles(String, String, Boolean, SearchOption)

指定されたテキストが格納されたファイル名を表す文字列の読み取り専用コレクションを返します。

FindInFiles(String, String, Boolean, SearchOption, String[])

指定されたテキストが格納されたファイル名を表す文字列の読み取り専用コレクションを返します。

FindInFiles(String, String, Boolean, SearchOption)

指定されたテキストが格納されたファイル名を表す文字列の読み取り専用コレクションを返します。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);
static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption) As ReadOnlyCollection(Of String)

パラメーター

directory
String

検索するディレクトリ。

containsText
String

検索文字列。

ignoreCase
Boolean

検索時に大文字と小文字を区別する場合は True。それ以外の場合は False。 既定値は True です。

searchType
SearchOption

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

戻り値

ReadOnlyCollection<String>

指定されたテキストを含んでいるファイルの名前の読み取り専用コレクション。

例外

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

directoryNothing または空の文字列です。

指定されたディレクトリが存在しません。

指定されたディレクトリが既存のファイルを指しています。

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

指定されたディレクトリ パスにコロン (:) が含まれているか、形式が無効です。

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

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

次の使用例は、ディレクトリで C:\TestDir 文字列 "sample string" を含むファイルを検索し、結果 ListBox1を表示します。

Dim list As System.Collections.ObjectModel.
  ReadOnlyCollection(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", 
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name In list
    ListBox1.Items.Add(name)
Next

作業するには、プロジェクト ListBox に名前付き ListBox1.

注釈

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

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

終了 解決方法については、
特定の文字列を含むファイルのディレクトリを検索する チュートリアル: Visual Basic によるファイルとディレクトリの操作

こちらもご覧ください

適用対象

FindInFiles(String, String, Boolean, SearchOption, String[])

指定されたテキストが格納されたファイル名を表す文字列の読み取り専用コレクションを返します。

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ fileWildcards);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);
static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption, ParamArray fileWildcards As String()) As ReadOnlyCollection(Of String)

パラメーター

directory
String

検索するディレクトリ。

containsText
String

検索文字列。

ignoreCase
Boolean

検索時に大文字と小文字を区別する場合は True。それ以外の場合は False。 既定値は True です。

searchType
SearchOption

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

fileWildcards
String[]

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

戻り値

ReadOnlyCollection<String>

指定されたテキストを含んでいるファイルの名前の読み取り専用コレクション。

例外

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

directoryNothing または空の文字列です。

指定されたディレクトリが存在しません。

指定されたディレクトリが既存のファイルを指しています。

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

指定されたディレクトリ パスにコロン (:) が含まれているか、形式が無効です。

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

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

次の使用例は、ディレクトリで C:\TestDir 文字列 "sample string" を含むファイルを検索し、結果 ListBox1を表示します。

Dim list As System.Collections.ObjectModel.
  ReadOnlyCollection(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", 
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name In list
    ListBox1.Items.Add(name)
Next

作業するには、プロジェクト ListBox に名前付き ListBox1.

注釈

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

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

終了 解決方法については、
特定の文字列を含むファイルのディレクトリを検索する チュートリアル: Visual Basic によるファイルとディレクトリの操作

こちらもご覧ください

適用対象