萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 操作 Excel 實現文本搜索:兩種遍歷方案與 UsedRange 索引陷阱

利用 COM 互操作(Microsoft.Office.Interop.Excel)在 Excel 文檔中搜索文本,本文對比兩種遍歷方案:Range.Find() 高效便捷 vs 手動遍歷 UsedRange 靈活可控,並揭示 UsedRange 索引起始值隨單元格區域變化的特殊行為。

核心對象模型

Application → Workbooks → Workbook → Worksheets → Worksheet → Range
  • Application:Excel 進程實例
  • Workbooks.Open():打開文件返回 Workbook
  • Worksheets:工作表集合,**索引從 1 開始**
  • UsedRange:已使用區域,動態變化

方案一:Range.Find() —— 推薦

object missing = Type.Missing;
string keyword = "搜索關鍵字";
Excel.Application app = new Excel.ApplicationClass();
Excel.Workbook wb = app.Workbooks.Open(filename, missing, missing, missing, missing,
    missing, missing, missing, missing, missing, missing, missing, missing, missing, missing);

foreach (Excel.Worksheet ws in wb.Worksheets) {
    Excel.Range found = ws.UsedRange.Find(
        keyword, missing, missing, missing, missing,
        Excel.XlSearchDirection.xlNext, missing, missing, missing);
    if (found != null) {
        MessageBox.Show($"找到於工作表 {ws.Name},地址 {found.Address}");
        break;
    }
}
wb.Close(false); app.Quit();

關鍵參數

  • What:搜索值
  • After:起始單元格(可選)
  • LookIn:xlValues/xlFormulas/xlComments
  • LookAt:xlWhole/xlPart
  • SearchDirection:xlNext/xlPrevious(必須顯式指定,Missing.Value 會導致編譯錯誤)

方案二:手動遍歷 UsedRange

bool found = false;
foreach (Excel.Worksheet ws in wb.Worksheets) {
    int rowCount = ws.UsedRange.Rows.Count;
    int colCount = ws.UsedRange.Columns.Count;
    int startRow = ws.UsedRange.Row;     // 關鍵:可能不是 1
    int startCol = ws.UsedRange.Column;  // 關鍵:可能不是 1

    for (int r = startRow; r < startRow + rowCount; r++) {
        for (int c = startCol; c < startCol + colCount; c++) {
            string cellText = ((Excel.Range)ws.Cells[r, c]).Text?.ToString() ?? "";
            if (cellText.IndexOf(keyword, StringComparison.OrdinalIgnoreCase) >= 0) {
                MessageBox.Show($"找到於 {ws.Name} R{r}C{c}");
                found = true; break;
            }
        }
        if (found) break;
    }
    if (found) break;
}

UsedRange 索引陷阱深度解析

「當工作表使用區域為單行單列時,索引從 1 開始;多行多列時,索引從 0 開始」—— 這是原文觀察到的現象,實際上是對 UsedRange.Row/Column 理解不準確。

真相

  • UsedRange.Row 返回區域**首行號**(1-based),Column 返回**首列號**(1-based)。
  • 單儲格 A1:Row=1, Column=1, Rows.Count=1, Columns.Count=1 → 遍歷 r=1..1, c=1..1 ✓
  • 區域 B2:D5:Row=2, Column=2, Rows.Count=4, Columns.Count=3 → 遍歷 r=2..5, c=2..4 ✓
  • 原代碼 iBgnRow = (Row>1)? Row-1 : Row **錯誤地減 1**,導致多行區域從 Row-1 開始,漏掉首行或越界。

正確遍歷模式


int firstRow = ws.UsedRange.Row;
int firstCol = ws.UsedRange.Column;
int lastRow = firstRow + ws.UsedRange.Rows.Count - 1;
int lastCol = firstCol + ws.UsedRange.Columns.Count - 1;

for (int r = firstRow; r <= lastRow; r++)
    for (int c = firstCol; c <= lastCol; c++)
        // 訪問 ws.Cells[r, c]

性能與選型建議

最佳實踐與坑點

  1. 釋放 COM 對象:循環中用 Marshal.ReleaseComObject(range),結束時 wb.Close(false)、app.Quit()、GC.Collect()、GC.WaitForPendingFinalizers()。
  2. 不打開可見 Excel:app.Visible = false,後台處理。
  3. 大文件改用 OpenXML / EPPlus:無需安裝 Office,純托管代碼,性能高 10-100 倍,支持 .xlsx 流式讀寫。
  4. UsedRange 可能包含歷史殘留格式單元格,建議 ws.UsedRange.SpecialCells(XlCellType.xlCellTypeLastCell) 定位真實邊界。

總結

Range.Find() 是搜索首選,簡潔高效。手動遍歷僅作為理解 Excel 對象模型、處理極特殊邏輯的備選。**牢記 Worksheets 與 Cells 索引從 1 開始**,UsedRange.Row/Column 反映真實起始位置,勿自行遞減。生產環境大量數據處理請遷移至 OpenXML SDK 或 EPPlus/NPOI 等純 .NET 庫。

copyright © 萬盛學電腦網 all rights reserved
維度Range.Find()手動遍歷
速度極快(內部優化)慢(跨進程 COM 調用每單元格)
靈活性固定匹配模式任意邏輯(正則、模糊、上下文)
格式感知可選 Values/Formulas/Comments僅 .Text (顯示文本) 或 .Value2
適用場景99% 搜索需求極其複雜的自定義匹配