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>
///
/// 编写 袁永福 （ http://www.xdesigner.cn ）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()
    {
        FileDirectoryEnumerator e = new FileDirectoryEnumerator();
        e.ReturnStringType = this.bolReturnStringType;
        e.SearchForDirectory = this.bolSearchForDirectory;
        e.SearchForFile = this.bolSearchForFile;
        e.SearchPath = this.strSearchPath;
        e.SearchPattern = this.strSearchPattern;
        e.ThrowIOException = this.bolThrowIOException;
        myList.Add(e);
        return e;
    }
    /// <summary>
    /// 关闭对象
    /// </summary>
    public void Close()
    {
        foreach (FileDirectoryEnumerator e in myList)
        {
            e.Close();
        }
        myList.Clear();
    }

    private System.Collections.ArrayList myList = new System.Collections.ArrayList();

}//public class FileDirectoryEnumerable : System.Collections.IEnumerable

/// <summary>
/// 文件和目录的遍历器
/// </summary>
/// <remarks>本对象为Win32API函数 FindFirstFile , FindNextFile
/// 和 FindClose 的一个包装
///
/// 以下代码演示使用了 FileDirectoryEnumerator
///
/// FileDirectoryEnumerator e = new FileDirectoryEnumerator();
/// e.SearchPath = @"c:\";
/// e.Reset();
/// e.ReturnStringType = true ;
/// while (e.MoveNext())
/// {
///     System.Console.WriteLine
///         ( e.LastAccessTime.ToString("yyyy-MM-dd HH:mm:ss")
///         + "   " + e.FileLength + "  \t" + e.Name );
/// }
/// e.Close();
/// System.Console.ReadLine();