このドキュメントはアーカイブされており、メンテナンスされていません。

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

更新 : 2007 年 11 月

指定した検索パターンに一致するディレクトリの配列を現在のディレクトリから取得します。

名前空間 :  System.IO
アセンブリ :  mscorlib (mscorlib.dll 内)

public static string[] GetDirectories(
	string path,
	string searchPattern
)
public static String[] GetDirectories(
	String path,
	String searchPattern
)
public static function GetDirectories(
	path : String, 
	searchPattern : String
) : String[]

パラメータ

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

戻り値

型 : System.String[]
検索パターンに一致するディレクトリの String 配列。

例外条件
UnauthorizedAccessException

呼び出し元に、必要なアクセス許可がありません。

ArgumentException

path が、長さが 0 の文字列であるか、空白しか含んでいないか、または InvalidPathChars で定義されている無効な文字を 1 つ以上含んでいます。

または

searchPattern に、有効なパターンが含まれていません。

ArgumentNullException

path または searchPatternnull です。

PathTooLongException

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。

IOException

path はファイル名です。

DirectoryNotFoundException

指定したパスが無効です (割り当てられていないドライブであるなど)。

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

ワイルドカード文字

説明

*

0 個以上の文字。

?

1 文字。

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

サブディレクトリが存在しない場合、または searchPattern パラメータに一致するサブディレクトリがない場合、このメソッドは空の配列を返します。

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

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

共通 I/O タスクの一覧については、「共通 I/O タスク」を参照してください。

指定した文字で始まるパス内のディレクトリの数をカウントするコード例を次に示します。

using System;
using System.IO;

class Test 
{
    public static void Main() 
    {
        try 
        {
            // Only get subdirectories that begin with the letter "p."
            string[] dirs = Directory.GetDirectories(@"c:\", "p*");
            Console.WriteLine("The number of directories starting with p is {0}.", dirs.Length);
            foreach (string dir in dirs) 
            {
                Console.WriteLine(dir);
            }
        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}


import System.*;
import System.IO.*;

class Test
{
    public static void main(String[] args)
    {
        try {
            // Only get subdirectories that begin with the letter "p."
            String dirs[] = Directory.GetDirectories("c:\\", "p*");

            Console.WriteLine("The number of directories starting "
                + "with p is {0}.", (Int32)dirs.length);
            String dir = "";
            for (int iCtr=0; iCtr < dirs.length; iCtr++) {
                dir = dirs[iCtr];
                Console.WriteLine(dir);
            }
        }
        catch (System.Exception e) {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    } //main
} //Test


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

.NET Framework

サポート対象 : 3.5、3.0、2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 3.5、2.0、1.0

XNA Framework

サポート対象 : 2.0、1.0
表示: