FileSystem.FindInFiles メソッド

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.Core.dll

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

オーバーロード

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

FindInFiles(String, String, Boolean, SearchOption)

ソース:

FileSystem.vb

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

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>

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

例外

ArgumentException

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

ArgumentNullException

directory が Nothing または空の文字列です。

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

例

次の使用例は、 ディレクトリ 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

作業するには、プロジェクトに という名前ListBox1の がListBox含まれている必要があります。

注釈

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

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

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

こちらもご覧ください

• SearchOption
• ReadOnlyCollection<T>

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

ソース:

FileSystem.vb

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

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>

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

例外

ArgumentException

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

ArgumentNullException

directory が Nothing または空の文字列です。

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

例

次の使用例は、 ディレクトリ 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

作業するには、プロジェクトに という名前ListBox1の がListBox含まれている必要があります。

注釈

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

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

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

こちらもご覧ください

• SearchOption
• ReadOnlyCollection<T>