C#过滤Excel文件遇异常：Range类_AutoFilter方法调用失败

问题背景 #

现有包含类型和数值的Excel文件（表格结构：V列为类型列，对应各行关联数值数据），需要筛选出指定类型的所有行，但使用C# Excel Interop代码时触发_AutoFilter method of Range class failed异常。

错误原因 #

1. AutoFilter应用范围错误：直接对单列Range调用AutoFilter，而非包含表头的完整数据区域
2. 操作符参数不匹配：使用xlFilterValues（用于多值筛选）但传入单个筛选值
3. 列索引获取逻辑问题：UsedRange.Columns["V"]的索引方式可能因UsedRange起始位置偏差导致错误
4. 未处理已有筛选：工作表若已存在筛选，重复调用会引发冲突

修正后的代码 #

using System;
using System.Windows.Forms;
using Microsoft.Office.Interop.Excel;
using System.Runtime.InteropServices;

public void ReadExcel(string SelectedType)
{
    string excelName = "";
    OpenFileDialog dialogRead = new OpenFileDialog();
    dialogRead.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    // 先判断用户是否选择了文件，避免空路径报错
    if (dialogRead.ShowDialog() != DialogResult.OK)
        return;
    excelName = dialogRead.FileName;

    Application excelApp = new Application();
    Workbook workbook = null;
    Worksheet worksheet = null;
    Range dataRange = null;

    try
    {
        workbook = excelApp.Workbooks.Open(excelName);
        // 注意工作表名称的空格，确认和实际表名完全一致
        worksheet = (Worksheet)workbook.Sheets["INVENTORY"];
        
        // 清除已有筛选（如果存在）
        if (worksheet.AutoFilter != null)
            worksheet.AutoFilterMode = false;

        // 获取包含表头的完整数据区域（假设表头在第1行）
        dataRange = worksheet.UsedRange;
        // 应用筛选：V列对应数字22，筛选值为SelectedType
        dataRange.AutoFilter(Field: 22, Criteria1: SelectedType, Operator: XlAutoFilterOperator.xlAnd);

        string newFilePath = "FilteredExcelFile.xlsx";
        workbook.SaveAs(newFilePath);
        MessageBox.Show("筛选完成，文件已保存");
    }
    catch (Exception ex)
    {
        MessageBox.Show($"出错：{ex.Message}");
    }
    finally
    {
        // 释放COM对象，避免Excel进程后台残留
        if (dataRange != null) Marshal.ReleaseComObject(dataRange);
        if (worksheet != null) Marshal.ReleaseComObject(worksheet);
        if (workbook != null)
        {
            workbook.Close();
            Marshal.ReleaseComObject(workbook);
        }
        excelApp.Quit();
        Marshal.ReleaseComObject(excelApp);
    }
}

关键修正点说明 #

• 清除已有筛选：通过worksheet.AutoFilterMode = false确保工作表无残留筛选，避免冲突
• 正确指定筛选范围：对整个UsedRange调用AutoFilter，用列号（V列对应22）替代字符串索引，避免偏移问题
• 匹配筛选操作符：单个值筛选使用xlAnd（可省略，默认即为该值），而非多值专用的xlFilterValues
• 增加鲁棒性处理：判断用户是否选择文件、添加异常捕获、释放COM对象防止Excel进程残留
• 验证工作表名称：原代码中"INVENTORY "末尾有空格，需确认和实际工作表名称完全一致，否则会因找不到表触发后续错误

内容的提问来源于stack exchange，提问作者Menna