14. 数据验证¶
本章介绍数据验证(下拉列表、数值 / 日期区间)的写出、验证类型,以及读回。
Warning
数据验证支持 xlsx / xlsm / xlsb 写出。写出到其他格式时验证被丢弃,经 OnDegradation 上报(见第 22 章)。
14.1 写出数据验证¶
Worksheet.Validations 为 List<DataValidation>,通过对象初始化器逐条配置验证规则:
var ws = Excel.Create().Worksheets["Sheet1"];
ws.Validations = new List<DataValidation>
{
// 下拉列表(逗号分隔,用引号包裹)
new DataValidation
{
Type = DataValidationType.List,
Sqref = "A1:A10",
Formula1 = "\"Active,Inactive,Pending\"",
AllowBlank = true,
PromptTitle = "请选择",
Prompt = "从下拉列表选择状态",
},
// 整数区间验证
new DataValidation
{
Type = DataValidationType.WholeNumber,
Sqref = "B1:B10",
Formula1 = "1",
Formula2 = "100",
},
};
DataValidation 参数:
| 参数 | 类型 | 说明 |
|---|---|---|
Type |
DataValidationType |
验证类型(见 14.2) |
Sqref |
string |
应用范围(A1 风格,如 A1:A10) |
Formula1 |
string |
列表验证为引号包裹的逗号分隔项;区间验证为下限 |
Formula2 |
string? |
区间验证上限(非区间可省略) |
AllowBlank |
bool |
是否允许空值(默认 false) |
PromptTitle / Prompt |
string? |
选中单元格时的输入提示标题 / 正文 |
14.2 数据验证类型 DataValidationType¶
DataValidationType 决定验证规则类别,配合 Formula1 / Formula2 使用:
List:下拉列表验证,Formula1用引号包裹的逗号分隔列表。WholeNumber/Decimal/Date:数值 / 日期验证,Formula1为下限、Formula2为上限(区间验证)。
14.3 读回数据验证¶
打开含数据验证的文件后,Worksheet.Validations 自动回填,遍历即可打印每条规则:
var opened = Excel.Open("validations.xlsx");
var validations = opened.Worksheets[0].Validations;
if (validations is not null)
foreach (var v in validations)
Console.WriteLine($"{v.Type} {v.Sqref} {v.Formula1} {v.Formula2}");
输出: