C使用WIN32API来高效率的遍历文件和目录.doc

C#使用 WIN32API 来高效率的遍历文件和目录

我们有时需要遍历某个目录下的文件和子目录，可以使用

System.IO.DirectoryInfo.GetDirectories 或 GetFiles 来获得目录下的所有的文件和子目

录，当这个目录下的内容比较多时，这个操作就比较耗时间，有时我们仅仅需要知道某个目录

下是否有子目录，这样的操作显然是浪费时间的。此时我们很容易想到三个 Win32API 函数
FindFirstFile，FindNextFile 和 FindClose。这三个 API 搭配使用就能遍历文件和子目录了，

而且可以遍历的时候随时中止，避免无谓的操作。

C#中可以使用 foreach 来遍历某个序列，遍历使用的对象必须实现

System.Collections.IEnumeable 接口，而内部调用的遍历器则必须实现

System.Collections.IEnumerator ， 为了使用方便，我们在使用 FindFirstFile 等 API 函

数时封装为 IEnumerator，而且实际上是有条件封装的。

这里很多人就会提到 C#调用 API 的执行效率问题，认为应当用 C，C++调用 API 才是正道，

使用 C#调用则有些鸡肋。但在我个人编程经历中，也有不少调用 API 的，经验发现其实效率

问题不大，可以省略。我只是做常规的运行在 PC 机上面的软件，CPU 通常超过 1GHZ，而且

无需考虑高实时性和高效率。若过于考虑效率问题会加大软件开发消耗。从工程开发管理方面

看是不合理的。我应当解决比较突出的效率问题，不突出的影响不大的效率问题有时间才去解

决。使用 C#封装 Win32API 必然会降低执行效率，但是封装后使用方便快捷，综合考虑认为

这是正确的。

这里说一下"技术镀金"这个问题，所谓技术镀金就是开发人员在项目软件开发中过于追求技术

的完美性，试图在技术上镀上一层完美的金壳，导致软件开发工作量加大，项目时间拉长，有

可能导致项目的失败。我吃过"技术镀金"的苦头，现在我内心是追求完美的，但实际开发时经

常有意压制追求完美的心思。

现在继续探讨封装大计，本次封装重点在于实现 IEnumerator,而 IEnumeable 只是
IEnumerator 的一个包装。IEnumerator 实现方法 Reset ， MoveNext 和属性 Current，

Reset 方法用于重新设置遍历器，MoveNext 用于查找下一个文件或目录，而 Current 返回当

前文件或目录。

这个遍历器还得注意 FindClose 的调用，必须在遍历完毕没有找到文件或子目录后调用，若不

调用该 API 函数则会造成内存泄漏。

根据上述设计，我写出如下代码，这段代码功能单一，希望有人能用得上

/// <summary>
/// 文件或目录遍历器,本类型为 FileDirectoryEnumerator 的一个包装
/// </summary>
/// <remarks>
///
/// 编写 袁永福 （ ）2006-12-8
///
/// 以下代码演示使用这个文件目录遍历器
///
/// FileDirectoryEnumerable e = new FileDirectoryEnumerable();
/// e.SearchPath = @"c:\";
/// e.ReturnStringType = true ; /// e.SearchPattern = "*.exe"; /// e.SearchDirectory = false ;
/// e.SearchFile = true;
/// foreach (object name in e)
/// {
/// System.Console.WriteLine(name);
/// }
/// System.Console.ReadLine();
///
///</remarks>
public class FileDirectoryEnumerable : System.Collections.IEnumerable
{
private bool bolReturnStringType = true;
/// <summary>
/// 是否以字符串方式返回查询结果,若返回 true 则当前对象返回为字符串,
/// 否则返回 System.IO.FileInfo 或 System.IO.DirectoryInfo 类型
/// </summary>
public bool ReturnStringType
{
get { return bolReturnStringType; }
set { bolReturnStringType = value; }
}

private string strSearchPattern = "*";
/// <summary>
/// 文件或目录名的通配符
/// </summary>
public string SearchPattern
{
get { return strSearchPattern; }

set { strSearchPattern = value; }
}
private string strSearchPath = null;
/// <summary>
/// 搜索路径,必须为绝对路径
/// </summary>
public string SearchPath
{
get { return strSearchPath; }
set { strSearchPath = value; }
}

private bool bolSearchForFile = true;
/// <summary>
/// 是否查找文件
/// </summary>
public bool SearchForFile
{
get { return bolSearchForFile; }
set { bolSearchForFile = value; }
}
private bool bolSearchForDirectory = true;
/// <summary>
/// 是否查找子目录
/// </summary>
public bool SearchForDirectory
{
get { return bolSearchForDirectory; }
set { bolSearchForDirectory = value; }
}

private bool bolThrowIOException = true;
/// <summary>
/// 发生 IO 错误时是否抛出异常
/// </summary>
public bool ThrowIOException
{
get { return this.bolThrowIOException; }
set { this.bolThrowIOException = value; }
}
/// <summary>
/// 返回内置的文件和目录遍历器
/// </summary>
/// <returns>遍历器对象</returns>
public System.Collections.IEnumerator GetEnumerator()
{