ExcelDataReader读取单元格布尔值(Yes/No、复选框)返回null解决方法

你遇到的布尔值/Yes/No/复选框读取返回null，本质分两类场景：

• 普通单元格设置布尔格式、数据验证下拉Yes/No的场景：读取配置缺省参数，导致ExcelDataReader对布尔类型列的类型映射失败，返回null
• 表单控件/ActiveX复选框场景：这类控件的选中状态默认不存储在单元格的Value属性中，ExcelDataReader本身不解析表单控件内容，直接读对应单元格自然返回null

场景1：读取单元格本身存储的Yes/No/布尔值 #

调整AsDataSet的初始化配置，补全类型推断相关参数，根据你需要的返回值格式选对应配置即可：

方案A：直接获取原生布尔值 #

配置后布尔列会返回System.Boolean类型，true对应Excel里的Yes/选中，false对应No/未选中：

var excelDataSet = reader.AsDataSet(new ExcelDataSetConfiguration 
{
    ConfigureDataTable = (_) => new ExcelDataTableConfiguration 
    { 
        UseHeaderRow = true,
        UseColumnDataType = true, // 显式开启列类型自动推断，规避版本默认值差异
        ReadFormatString = false // 读取单元格底层存储值，而非格式化显示文本
    }
});

取值时做类型判断即可：

var cellValue = table.Rows[rowNumber][colNumber];
if (cellValue is bool boolRes)
{
    // boolRes为true就是Yes/选中，false就是No/未选中
}

方案B：直接获取显示的Yes/No文本 #

如果不需要布尔类型，想直接拿到单元格展示的文本内容，修改配置读取格式化值即可，不会返回null：

var excelDataSet = reader.AsDataSet(new ExcelDataSetConfiguration 
{
    ConfigureDataTable = (_) => new ExcelDataTableConfiguration 
    { 
        UseHeaderRow = true,
        ReadFormatString = true // 直接读取单元格显示的格式化文本
    }
});

取值时直接判断字符串内容：

var cellValue = table.Rows[rowNumber][colNumber]?.ToString();
bool isChecked = string.Equals(cellValue, "Yes", StringComparison.OrdinalIgnoreCase);

兼容性兜底方案 #

如果你的XLS是第三方系统导出的，存在列类型混杂、带不可见特殊字符的情况，直接关闭自动类型推断，所有单元格按原始字符串读取，从根源避免类型转换导致的null：

var excelDataSet = reader.AsDataSet(new ExcelDataSetConfiguration 
{
    ConfigureDataTable = (_) => new ExcelDataTableConfiguration 
    { 
        UseHeaderRow = true,
        UseColumnDataType = false // 全列按字符串读取
    }
});

场景2：读取表单/ActiveX复选框的值 #

ExcelDataReader没有提供工作表控件的解析接口，这类场景不要在当前库上找不存在的API，按以下方式处理：

• 如果可以修改源Excel文件：给所有复选框设置「单元格链接」，绑定到对应位置的单元格，绑定后复选框的选中状态会自动以布尔值存入绑定单元格，用上面的配置就能直接读取
• 如果无法修改源文件：换用支持解析Excel控件的库（比如NPOI、EPPlus）单独读取工作表的控件集合，匹配复选框的位置、关联单元格拿到选中状态。

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