DirectoryInfo.GetFileSystemInfos メソッド (String)

指定した検索基準に一致する、厳密に型指定された FileSystemInfo オブジェクトの配列を取得します。

Overloads Public Function GetFileSystemInfos( _
   ByVal searchPattern As String _) As FileSystemInfo()
[C#]
public FileSystemInfo[] GetFileSystemInfos(stringsearchPattern);
[C++]
public: FileSystemInfo* GetFileSystemInfos(String* searchPattern) [];
[JScript]
public function GetFileSystemInfos(
   searchPattern : String) : FileSystemInfo[];

パラメータ

• searchPattern
  検索文字列。たとえば、単語 "System" で始まるすべてのディレクトリを検索するには、"System*" を指定します。

戻り値

検索基準に一致する、厳密に型指定された FileSystemInfo オブジェクトの配列。

例外

例外の種類	条件
ArgumentNullException	searchPattern が null 参照 (Visual Basic では Nothing) です。
DirectoryNotFoundException	割り当てられていないドライブであるなど、指定されたパスが無効です。
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

ワイルドカードを使用できます。たとえば、 searchPattern に文字列 "*t" を指定すると、 path 内のすべてのディレクトリ名のうち、文字 "t" で終わる名前が検索されます。 searchPattern に文字列 "s*" を指定した場合は、 path 内のすべてのディレクトリ名のうち、文字 "s" で始まる名前が検索されます。文字列 ".." は、ディレクトリ名 "a..b" のような有効なディレクトリ名の一部として指定する場合にだけ、 searchPattern に指定できます。ディレクトリ階層を上に移動するためには使用できません。ファイルまたはディレクトリが存在しないか、 DirectoryInfo 内に searchPattern 文字列に一致するファイルまたはディレクトリがない場合、このメソッドは空の配列を返します。

このメソッドの使用例については、以下の「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	ファイルへのテキストの書き込み
テキスト ファイルに書き込む。	ファイルへのテキストの書き込み
テキスト ファイルから読み取る。	ファイルからのテキストの読み取り
ディレクトリをコピーする。	Directory
ディレクトリの名前を変更、またはディレクトリを移動する。	Directory.Move DirectoryInfo.MoveTo
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルを削除する。	File.Delete FileInfo.Delete
ディレクトリを削除する。	Directory.Delete DirectoryInfo.Delete
ディレクトリを作成する。	CreateDirectory Directory
サブディレクトリを作成する。	CreateSubdirectory
ディレクトリ内のファイルを参照する。	Name
ディレクトリ内のサブディレクトリを参照する。	GetDirectories GetDirectories
ディレクトリのサイズを取得する。	Directory
ファイルが存在するかどうかを判別する。	Exists
ディレクトリが存在するかどうかを判別する。	Exists
ファイルの属性を設定する。	SetAttributes
ファイルの属性を取得する。	GetAttributes

使用例

[Visual Basic, C#, C++] 指定した検索パターンに一致するファイルおよびディレクトリの数をカウントする例を次に示します。

 
Imports System
Imports System.IO

Public Class Test
    Public Shared Sub Main()
        ' Specify the directories you want to manipulate.
        Dim di As DirectoryInfo = New DirectoryInfo("c:\")
        Try
            ' Get only subdirectories that contain the letter "p."
            Dim dirs As FileSystemInfo() = di.GetDirectories("*p*")
            Console.WriteLine("Number of directories with a p: {0}", dirs.Length)
            Dim diNext As DirectoryInfo

            ' Count all the files in each subdirectory that contain the letter "e."
            For Each diNext In dirs
                Console.WriteLine("The number of files and directories " + _
                 "in {0} with an e is {1}", diNext, _
                 diNext.GetFileSystemInfos("*e*").Length)
            Next
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

[C#] 
using System;
using System.IO;

class Test 
{
    public static void Main() 
    {
        try 
        {
            DirectoryInfo di = new DirectoryInfo(@"c:\");
            // Get only subdirectories that contain the letter "p."
            FileSystemInfo[] dirs = di.GetDirectories("*p*");
            Console.WriteLine("Number of directories with a p: {0}", dirs.Length);
            // Count all the files in each subdirectory that contain the letter "e."
            foreach (DirectoryInfo diNext in dirs) 
            {
                Console.WriteLine("The number of files and directories " +
                    "in {0} with an e is {1}", diNext, 
                    diNext.GetFileSystemInfos("*e*").Length);
            }
        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

[C++] 
#using <mscorlib.dll>

using namespace System;
using namespace System::IO;

int main() {
    try {
        DirectoryInfo* di = new DirectoryInfo(S"c:\\");
        // Get only subdirectories that contain the letter S"p."
        FileSystemInfo* dirs[] = di->GetDirectories(S"*p*");
        Console::WriteLine(S"Number of directories with a p: {0}", __box(dirs->Length));
        // Count all the files in each subdirectory that contain the letter "e."
        Collections::IEnumerator* myEnum = dirs->GetEnumerator();
        while (myEnum->MoveNext()) {
            DirectoryInfo* diNext = __try_cast<DirectoryInfo*>(myEnum->Current);

            Console::WriteLine(S"The number of files and directories in {0} with an e is {1}", diNext, 
                __box(diNext->GetFileSystemInfos(S"*e*")->Length));
        }
    } catch (Exception* e) {
        Console::WriteLine(S"The process failed: {0}", e);
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

• FileIOPermission (ファイルやディレクトリから読み取ったり、それらのパスにアクセスしたりするために必要なアクセス許可) FileIOPermissionAccess.Read 、 FileIOPermissionAccess.PathDiscovery (関連する列挙体)

参照

DirectoryInfo クラス | DirectoryInfo メンバ | System.IO 名前空間 | DirectoryInfo.GetFileSystemInfos オーバーロードの一覧 | FileSystemInfo | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み