C#使用WIN32API來遍歷文件和目錄[1]

    我們有時需要遍歷某個目錄下的文件和子目錄，可以使用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();
   }

原文轉自：http://www.anti-gravitydesign.com