使用 C# 设置 Excel 单元格数据验证

在日常报表开发中，Excel 的数据准确性和可控性与格式美观同样重要。通过合理设置数据验证，可以防止输入错误、约束填报规则，从而提升数据的可靠性和规范性。

相比手动设置验证规则，使用 C# 程序自动化生成 Excel 数据验证 不仅能提高效率，还能保证规则统一。本文演示如何在 同一个工作表中 设置 下拉列表、数值范围、日期区间、文本长度、自定义公式和输入提示，并结合实际业务场景帮助你理解数据验证的作用。

本文使用的方法基于 Free Spire.XLS for .NET。安装方式（NuGet）如下：

bash 复制代码

Install-Package FreeSpire.XLS

1. 初始化工作簿和工作表

csharp 复制代码

using Spire.Xls;

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
sheet.Name = "员工信息录入";

操作说明 ：

这里新建了一个 Excel 文件并获取第一个工作表，命名为"员工信息录入"。所有验证规则都会集中展示在这个表中，保证操作有条理。

2. 下拉列表验证（部门选择）

在实际业务中，员工部门字段通常是固定的几个选项，例如"人事部""财务部""技术部""市场部"。通过下拉列表验证，可以避免用户随意输入错误部门名称。

csharp 复制代码

// 部门列表
sheet.Range["A1"].Text = "可选部门：";
sheet.Range["A2"].Text = "人事部";
sheet.Range["A3"].Text = "财务部";
sheet.Range["A4"].Text = "技术部";
sheet.Range["A5"].Text = "市场部";

// 员工录入区
sheet.Range["C1"].Text = "所属部门：";
CellRange deptCell = sheet.Range["C2"];

deptCell.DataValidation.AllowType = CellDataType.Formula;
// 设置下拉列表数据源
deptCell.DataValidation.DataRange = sheet.Range["A2:A5"];
// 也可直接设置列表内容
//deptCell.DataValidation.Values = ["人事部", "财务部", "技术部", "市场部"];
deptCell.DataValidation.ShowError = true;
deptCell.DataValidation.AlertStyle = AlertStyleType.Stop;
deptCell.DataValidation.ErrorTitle = "输入错误";
deptCell.DataValidation.ErrorMessage = "请从下拉列表中选择部门！";

// 输入提示
deptCell.DataValidation.ShowInput = true;
deptCell.DataValidation.InputTitle = "选择部门";
deptCell.DataValidation.InputMessage = "请从固定部门列表中选择。";

使用场景：避免部门名称不统一（如"技术""技术部"混用）。

保存文件后效果：

3. 数值验证（员工年龄）

员工年龄一般处于一定范围内，比如 18 到 60 岁。我们可以通过数值验证来限制输入。

csharp 复制代码

sheet.Range["D1"].Text = "员工年龄 (18-60)：";
CellRange ageCell = sheet.Range["D2"];

ageCell.DataValidation.AllowType = CellDataType.Integer;
ageCell.DataValidation.CompareOperator = ValidationComparisonOperator.Between;
ageCell.DataValidation.Formula1 = "18";
ageCell.DataValidation.Formula2 = "60";
ageCell.DataValidation.ShowError = true;
ageCell.DataValidation.ErrorMessage = "请输入 18 到 60 之间的整数！";

使用场景：保证录入的年龄数据合理，不会出现"5 岁员工"或"100 岁员工"的异常数据。

保存文件后效果：

4. 日期验证（入职日期）

企业通常要求员工入职日期在某一合理区间内。例如，录入表只允许选择 2023 年内的入职日期。

csharp 复制代码

sheet.Range["E1"].Text = "入职日期 (2023年)：";
CellRange hireDateCell = sheet.Range["E2"];

hireDateCell.DataValidation.AllowType = CellDataType.Date;
hireDateCell.DataValidation.CompareOperator = ValidationComparisonOperator.Between;
hireDateCell.DataValidation.Formula1 = "2023-01-01";
hireDateCell.DataValidation.Formula2 = "2023-12-31";
hireDateCell.DataValidation.ShowError = true;
hireDateCell.DataValidation.ErrorMessage = "请输入 2023 年的有效日期！";

使用场景：确保录入的入职时间不会超出考勤和人事系统设定范围。

保存文件后效果：

5. 文本长度验证（工号）

工号通常有固定的位数，例如必须是 6 位字符。通过文本长度验证可以保证工号录入规范。

csharp 复制代码

sheet.Range["F1"].Text = "工号 (6位)：";
CellRange idCell = sheet.Range["F2"];

idCell.DataValidation.AllowType = CellDataType.TextLength;
idCell.DataValidation.CompareOperator = ValidationComparisonOperator.Equal;
idCell.DataValidation.Formula1 = "6";
idCell.DataValidation.ShowError = true;
idCell.DataValidation.ErrorMessage = "工号必须为 6 位字符！";

使用场景：避免工号录入长度不一导致系统识别异常。

保存文件后效果：

6. 自定义公式验证（工资 > 基本工资）

在工资表中，往往需要确保"实发工资"大于"基本工资"。我们可以使用自定义公式来实现这种逻辑。

csharp 复制代码

sheet.Range["G1"].Text = "基本工资：";
sheet.Range["G2"].NumberValue = 4000;
sheet.Range["H1"].Text = "实发工资：";
CellRange salaryCell = sheet.Range["H2"];

salaryCell.DataValidation.AllowType = CellDataType.Formula;
salaryCell.DataValidation.Formula1 = "=H2>G2";
salaryCell.DataValidation.ShowError = true;
salaryCell.DataValidation.ErrorMessage = "实发工资必须大于基本工资！";

使用场景：避免出现"实发工资比基本工资还低"的错误数据。

保存文件后效果：

7. 保存文件

完成所有验证规则设置后，将结果保存为 Excel 文件：

csharp 复制代码

// 自动对齐并保存
sheet.Range.Style.Font.FontName = "微软雅黑";
sheet.Range.Style.Font.Size = 12f;
sheet.Range.AutoFitColumns();
workbook.SaveToFile("DataValidation.xlsx", ExcelVersion.Version2016);

关键类与属性总结

类 / 属性	说明
`Workbook`	表示 Excel 工作簿，用于创建和保存文件
`Worksheet`	表示 Excel 工作表，所有操作都基于该对象
`CellRange`	表示单元格或单元格区域
`DataValidation`	用于设置单元格数据验证规则
`AllowType`	指定验证类型（整数、日期、文本长度、自定义公式等）
`CompareOperator`	指定比较运算符（Between、Equal 等）
`Formula1` / `Formula2`	用于设置验证条件的参数值
`ShowError`	是否显示错误提示
`ErrorMessage`	错误提示信息
`ShowInput`	是否显示输入提示
`InputMessage`	输入提示信息

总结

本文通过 Spire.XLS for .NET 演示了如何在一张 Excel 工作表中设置多种类型的数据验证，包括下拉列表、数值范围、日期区间、文本长度、自定义公式以及输入提示。通过这些验证规则，可以有效减少错误输入，统一数据标准，提升报表质量。如果你正在开发人事、财务或其他需要批量数据录入的系统，使用 C# 自动化设置 Excel 数据验证会大大提高效率和准确性。