Directory.GetFiles メソッド (String, String)

指定したディレクトリ内の指定した検索パターンに一致するファイル名を返します。

Overloads Public Shared Function GetFiles( _
   ByVal path As String, _   ByVal searchPattern As String _) As String()
[C#]
public static string[] GetFiles(stringpath,stringsearchPattern);
[C++]
public: static String* GetFiles(String* path,String* searchPattern)  __gc[];
[JScript]
public static function GetFiles(
   path : String,searchPattern : String) : String[];

パラメータ

• path
  検索するディレクトリ。
• searchPattern
  path 内のファイル名と対応させる検索文字列。このパラメータは、2 つのピリオド ("..") で終了することはできません。また、2 つのピリオド ("..") に続けて DirectorySeparatorChar または AltDirectorySeparatorChar を指定したり、 InvalidPathChars の文字を含めたりすることはできません。

戻り値

指定したディレクトリ内の指定した検索パターンに一致するファイル名を格納する String 配列。

例外

解説

searchPattern で許可されるワイルドカード指定子を次に示します。

ワイルドカード指定子以外の文字は、その文字自体を表します。たとえば、 searchPattern 文字列 "*t" は、 path 内で、文字 "t" で終わるすべての名前を検索します。 searchPattern 文字列 "s*" は、 path 内で、文字 "s" で始まるすべての名前を検索します。

拡張子の長さがちょうど 3 文字の場合の searchPattern の一致の動作は、拡張子が 3 文字を超えている場合の動作と異なります。ちょうど 3 文字の searchPattern の場合は、3 文字以上の拡張子を持つファイルが返されます。 searchPattern の文字数が 1、2、または 4 以上の場合は、その長さを持つ拡張子のファイルだけが返されます。

searchPattern パラメータにさまざまな長さが設定された場合の動作を次のリストに示します。

• "*.abc" の場合、.abc、.abcd、.abcde、.abcdef などの拡張子を持つファイルが返されます。
• "*.abcd" の場合、拡張子 .abcd のファイルだけが返されます。
• "*.abcde" の場合、拡張子 .abcde のファイルだけが返されます。
• "*.abcdef" の場合、拡張子 .abcdef のファイルだけが返されます。

path パラメータは、相対パス情報または絶対パス情報を指定することを許可されています。相対パス情報は、現在の作業ディレクトリに対して相対的に解釈されます。現在の作業ディレクトリを取得するには、 GetCurrentDirectory のトピックを参照してください。

path パラメータでは大文字と小文字が区別されません。

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

使用例

[Visual Basic, C#, C++] 指定した文字で始まるファイルの数をカウントする例を次に示します。

 
Imports System
Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Try
            ' Only get files that begin with the letter "c."
            Dim dirs As String() = Directory.GetFiles("c:\", "c*")
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length)
            Dim dir As String
            For Each dir In dirs
                Console.WriteLine(dir)
            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 
        {
            // Only get files that begin with the letter "c."
            string[] dirs = Directory.GetFiles(@"c:\", "c*");
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length);
            foreach (string dir in dirs) 
            {
                Console.WriteLine(dir);
            }
        } 
        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 {
        // Only get files that begin with the letter "c."
        String* dirs[] = Directory::GetFiles(S"c:\\", S"c*");
        Console::WriteLine(S"The number of files starting with c is {0}.", __box(dirs->Length));
        Collections::IEnumerator* myEnum = dirs->GetEnumerator();
        while (myEnum->MoveNext()) {
            Console::WriteLine(myEnum->Current);
        }
    } 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, Common Language Infrastructure (CLI) Standard

.NET Framework セキュリティ:

• FileIOPermission (現在のディレクトリのパス情報にアクセスするために必要な許可) FileIOPermissionAccess.PathDiscovery (関連する列挙体)

参照

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