本文档已存档,并且将不进行维护。

Directory.GetFiles 方法 (String)

更新:2007 年 11 月

返回指定目录中的文件的名称。

命名空间:  System.IO
程序集:  mscorlib(在 mscorlib.dll 中)

public static string[] GetFiles(
	string path
)
public static String[] GetFiles(
	String path
)
public static function GetFiles(
	path : String
) : String[]

参数

path
类型:System.String
将从其检索文件的目录。

返回值

类型:System.String[]
指定目录中文件名的 String 数组。

异常条件
IOException

path 是一个文件名。

UnauthorizedAccessException

调用方没有所要求的权限。

ArgumentException

path 是一个零长度字符串,仅包含空白或者包含一个或多个由 InvalidPathChars 定义的无效字符。

ArgumentNullException

pathnull

PathTooLongException

指定的路径、文件名或者两者都超出了系统定义的最大长度。例如,在基于 Windows 的平台上,路径必须小于 248 个字符,文件名必须小于 260 个字符。

DirectoryNotFoundException

指定的路径无效(例如,它位于未映射的驱动器上)。

将返回的文件名追加到提供的 path 参数中。

如果不存在文件,该方法将返回空数组。

此方法与将星号 (*) 指定为搜索模式的 GetFiles 方法相同。

允许 path 参数指定相对或绝对路径信息。相对路径信息被解释为相对于当前工作目录。若要获取当前工作目录,请参见 GetCurrentDirectory

返回文件的名称顺序无法保证;如果需要特定排序顺序,请使用 Sort() 方法。

path 参数不区分大小写。

有关通用 I/O 任务的列表,请参见 通用 I/O 任务

下面的示例演示如何使用 GetFiles 方法从用户指定的位置返回文件名。将该示例配置为捕捉此方法的所有常见错误。

// 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);	    
    }
}


// For Directory.GetFiles and Directory.GetDirectories
// For File.Exists, Directory.Exists
import System.*;
import System.IO.*;
import System.Collections.*;

public class RecursiveFileProcessor
{
    public static void main(String[] args)
    {
        for (int iCtr = 0; iCtr < args.get_Length(); iCtr++) {
            String path = args[iCtr];
            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);
                }
            }
        }
    } //main

    // 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);
        for (int iCtr1 = 0; iCtr1 < fileEntries.get_Length(); iCtr1++) {
            String fileName = fileEntries[iCtr1];
            ProcessFile(fileName);
        }
        // Recurse into subdirectories of this directory.
        String subDirectoryEntries[] = 
            Directory.GetDirectories(targetDirectory);
        for (int iCtr2 = 0; iCtr2 < subDirectoryEntries.get_Length(); 
            iCtr2++) {
            String subDirectory = subDirectoryEntries[iCtr2];
            ProcessDirectory(subDirectory);
        }
    } //ProcessDirectory

    // Insert logic for processing found files here.
    public static void ProcessFile(String path)
    {
        Console.WriteLine("Processed file '{0}'.", path);
    } //ProcessFile
} //RecursiveFileProcessor


//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 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
显示: