跳转至

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 使用:

public enum DataValidationType { List, WholeNumber, Decimal, Date }
  • 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}");

输出:

List A1:A10 Active,Inactive,Pending 
WholeNumber B1:B10 1 100

数据验证下拉的效果见[第 10 章](comments.md)的截图。