指定したディレクトリ内のサブディレクトリの名前を取得します。
Overloads Public Shared Function GetDirectories( _
ByVal path As String _) As String()
[C#]
public static string[] GetDirectories(stringpath);
[C++]
public: static String* GetDirectories(String* path) __gc[];
[JScript]
public static function GetDirectories(
path : String) : String[];
パラメータ
- path
サブディレクトリ名の配列が返されるパス。
戻り値
path 内のサブディレクトリの名前を格納している String 型の配列。
例外
例外の種類 | 条件 |
---|---|
UnauthorizedAccessException | 呼び出し元に、必要なアクセス許可がありません。 |
ArgumentException | path が、長さが 0 の文字列であるか、空白しか含んでいないか、または InvalidPathChars で定義されている無効な文字を 1 つ以上含んでいます。 |
ArgumentNullException | path が null 参照 (Visual Basic では Nothing) です。 |
PathTooLongException | 指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。 |
IOException | path はファイル名です。 |
DirectoryNotFoundException | 割り当てられていないドライブであるなど、指定されたパスが無効です。 |
解説
path パラメータは、相対パス情報または絶対パス情報を指定することを許可されています。相対パス情報は、現在の作業ディレクトリに対して相対的に解釈されます。現在の作業ディレクトリを取得するには、 GetCurrentDirectory のトピックを参照してください。
このメソッドは、検索パターンとしてアスタリスク (*) を指定した GetDirectories(String, String) とまったく同じです。
このメソッドで返される名前の先頭には、 path で提供されるディレクトリ情報が付きます。
path パラメータでは大文字と小文字が区別されません。
このメソッドの使用例については、以下の「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。
実行するタスク | 参考例があるトピック |
---|---|
テキスト ファイルを作成する。 | ファイルへのテキストの書き込み |
テキスト ファイルに書き込む。 | ファイルへのテキストの書き込み |
テキスト ファイルから読み取る。 | ファイルからのテキストの読み取り |
ディレクトリをコピーする。 | Directory |
ディレクトリの名前を変更、またはディレクトリを移動する。 | Directory.Move |
ディレクトリを削除する。 | Directory.Delete |
ディレクトリを作成する。 | CreateDirectory |
サブディレクトリを作成する。 | CreateSubdirectory |
ディレクトリ内のファイルを参照する。 | Name |
ディレクトリ内のすべてのサブディレクトリにあるすべてのファイルを参照する。 | GetFileSystemInfos |
ディレクトリのサイズを取得する。 | Directory |
ファイルが存在するかどうかを判別する。 | Exists |
ディレクトリが存在するかどうかを判別する。 | Exists |
使用例
ファイル名またはディレクトリ名の配列をコマンドラインから受け取り、名前の種類を判断し、適切な処理を行う例を次に示します。
' For Directory.GetFiles and Directory.GetDirectories
' For File.Exists, Directory.Exists
Imports System
Imports System.IO
Imports System.Collections
Public Class RecursiveFileProcessor
Public Overloads Shared Sub Main(ByVal args() As String)
Dim path As String
For Each path In args
If File.Exists(path) Then
' This path is a file.
ProcessFile(path)
Else
If Directory.Exists(path) Then
' This path is a directory.
ProcessDirectory(path)
Else
Console.WriteLine("{0} is not a valid file or directory.", path)
End If
End If
Next path
End Sub 'Main
' Process all files in the directory passed in, recurse on any directories
' that are found, and process the files they contain.
Public Shared Sub ProcessDirectory(ByVal targetDirectory As String)
Dim fileEntries As String() = Directory.GetFiles(targetDirectory)
' Process the list of files found in the directory.
Dim fileName As String
For Each fileName In fileEntries
ProcessFile(fileName)
Next fileName
Dim subdirectoryEntries As String() = Directory.GetDirectories(targetDirectory)
' Recurse into subdirectories of this directory.
Dim subdirectory As String
For Each subdirectory In subdirectoryEntries
ProcessDirectory(subdirectory)
Next subdirectory
End Sub 'ProcessDirectory
' Insert logic for processing found files here.
Public Shared Sub ProcessFile(ByVal path As String)
Console.WriteLine("Processed file '{0}'.", path)
End Sub 'ProcessFile
End Class 'RecursiveFileProcessor
[C#]
// For Directory.GetFiles and Directory.GetDirectories
// For File.Exists, Directory.Exists
using System;
using System.IO;
using System.Collections;
public class RecursiveFileProcessor
{
public static void Main(string[] args)
{
foreach(string path in args)
{
if(File.Exists(path))
{
// This path is a file
ProcessFile(path);
}
else if(Directory.Exists(path))
{
// This path is a directory
ProcessDirectory(path);
}
else
{
Console.WriteLine("{0} is not a valid file or directory.", path);
}
}
}
// Process all files in the directory passed in, recurse on any directories
// that are found, and process the files they contain.
public static void ProcessDirectory(string targetDirectory)
{
// Process the list of files found in the directory.
string [] fileEntries = Directory.GetFiles(targetDirectory);
foreach(string fileName in fileEntries)
ProcessFile(fileName);
// Recurse into subdirectories of this directory.
string [] subdirectoryEntries = Directory.GetDirectories(targetDirectory);
foreach(string subdirectory in subdirectoryEntries)
ProcessDirectory(subdirectory);
}
// Insert logic for processing found files here.
public static void ProcessFile(string path)
{
Console.WriteLine("Processed file '{0}'.", path);
}
}
[C++]
// For Directory::GetFiles and Directory::GetDirectories
// For File::Exists, Directory::Exists
#using <mscorlib.dll>
using namespace System;
using namespace System::IO;
using namespace System::Collections;
// Insert logic for processing found files here.
void ProcessFile(String* path) {
Console::WriteLine(S"Processed file '{0}'.", path);
}
// Process all files in the directory passed in, recurse on any directories
// that are found, and process the files they contain.
void ProcessDirectory(String* targetDirectory) {
// Process the list of files found in the directory.
String* fileEntries[] = Directory::GetFiles(targetDirectory);
IEnumerator* files = fileEntries->GetEnumerator();
while (files->MoveNext()) {
String* fileName = __try_cast<String*>(files->Current);
ProcessFile(fileName);
}
// Recurse into subdirectories of this directory.
String* subdirectoryEntries[] = Directory::GetDirectories(targetDirectory);
IEnumerator* dirs = subdirectoryEntries->GetEnumerator();
while (dirs->MoveNext()) {
String* subdirectory = __try_cast<String*>(dirs->Current);
ProcessDirectory(subdirectory);
}
}
int main(int argc, char* argv[]) {
for(int i=1; i < argc; i++) {
String* path = argv[i];
if (File::Exists(path)) {
// This path is a file
ProcessFile(path);
} else if (Directory::Exists(path)) {
// This path is a directory
ProcessDirectory(path);
}else {
Console::WriteLine(S"{0} is not a valid file or directory.", path);
}
}
}
[JScript]
//For Directory.GetFiles and Directory.GetDirectories
import System;
import System.IO;
import System.Collections;
// For File.Exists, Directory.Exists
// Takes an array of file names or directory names on the command line.
// Determines what kind of name it is and processes it appropriately
public class RecursiveFileProcessor {
public static function Main(args : String[]) : void {
for(var i : int in args) {
var path : String = args[i];
if (File.Exists(path)) {
// This path is a file
ProcessFile(path);
}
else if(Directory.Exists(path)) {
// This path is a directory
ProcessDirectory(path);
}
else {
Console.WriteLine("{0} is not a valid file or directory.", path);
}
}
}
// Process all files in the directory passed in, and recurse on any directories
// that are found to process the files they contain
public static function ProcessDirectory(targetDirectory : String) : void {
// Process the list of files found in the directory
var fileEntries : String [] = Directory.GetFiles(targetDirectory);
for (var i : int in fileEntries)
ProcessFile(fileEntries[i]);
// Recurse into subdirectories of this directory
var subdirectoryEntries : String[] = Directory.GetDirectories(targetDirectory);
for (i in subdirectoryEntries)
ProcessDirectory(subdirectoryEntries[i]);
}
// Real logic for processing found files would go here.
public static function ProcessFile(path : String) : void {
Console.WriteLine("Processed file '{0}'.", path);
}
}
// For JScript there is no 'Main' routine defined and hence the command line arguments
// have to be obtained with a call to System.Environment.GetCommandLineArgs
RecursiveFileProcessor.Main(System.Environment.GetCommandLineArgs());
必要条件
プラットフォーム: 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.GetDirectories オーバーロードの一覧 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み