C#使用Excel动态函数实现生成依赖列表
前言
在Excel 中,依赖列表或级联下拉列表表示两个或多个列表,其中一个列表的项根据另一个列表而变化。依赖列表通常用于Excel的业务报告,例如学术记分卡中的【班级-学生】列表、区域销售报告中的【区域-国家/地区】列表、人口仪表板中的【年份-区域】列表以及生产摘要报告中的【单位-行-产品】列表等等。
在本博客中,小编将为大家介绍如何借助葡萄城公司基于 .NET 和 .NET Core 平台的服务端高性能表格组件组件GrapeCity Documents for Excel (以下简称GcExcel)和动态数组函数 UNIQUE、CHOOSECOLS 和 FILTER 以编程方式创建主列表和依赖下拉列表。
背景需求
下图是一张某公司的客户订单表原始数据:
现在为了将这些数据按照人名分类进行查阅,小编需要制作两个下拉列表(客户姓名和订单ID),同时需要满足订单ID的值是与客户姓名相关的,然后最下面显示的是根据订单ID查询出来的订单详细信息,如下图所示:
使用GcExcel实现的步骤
步骤 1 - 工作簿初始化
使用 GcExcel API,第一步是初始化 Workbook 的实例。然后,您可以根据业务需求选择打开现有 Excel 文档或创建新工作簿。在此博客中,我们将使用带有 IWorkbook 接口的 API 加载包含客户订单历史记录的现有 Excel 文档,如下所示:
Workbook workbook = new Workbook(); workbook.Open("E:\\download\\smartdependentlist\\CustomerOrderHistory.xlsx");
步骤 2 - 获取工作表
接下来,您需要获取用于创建所需报告的工作表。使用 GcExcel,可以使用 IWorkbook 界面中的 API 获取工作表。您也可以选择创建一个新的工作表。但是,为了简化报表中使用的公式,我们将在存储订单历史记录的同一工作表上创建报表,如下所示:
IWorksheet worksheet; worksheet = workbook.Worksheets["data"]; //OR workbook.Worksheets[0];
步骤 3 - 获取客户名称的唯一列表(用于主下拉列表)
初始化后,需要获取要添加到报表中“选择客户名称”部分的主下拉列表的唯一客户名称列表。为此,请选择工作表中底部有空格的任何单元格以垂直溢出数据;我们使用了单元格T3。接下来,对所需的客户名称数据范围使用 UNIQUE 函数。
使用 GcExcel,可以使用带有 IWorksheet 接口的 API 获取单元格或单元格区域,并使用 IRange 接口的 API为其设置动态公式,如下所示:
IRange rngUniqueCustomerNames; rngUniqueCustomerNames = worksheet.Range["T3"]; //dummy cell to get unique list of customer names rngUniqueCustomerNames.Formula2 = "=UNIQUE($B$2:$B$2156)";
执行结果如下:
步骤 4 - 创建主下拉列表
获得客户名称列表后,将其用作使用“列表上的数据验证”创建的主下拉列表的源。在此博客示例中,此主下拉列表在单元格 L3 中创建。
使用 GcExcel,使用 IRange 接口的 API 在某个范围内配置数据验证。使用 IValidation 接口的 API 为区域添加新的验证规则实例。选择 ValidationType.List 列表类型数据验证选项,并使用 UNIQUE 公式将公式设置为单元格;这里是 T3,如下图所示:
IValidation listValidation = worksheet.Range["L3"].Validation; listValidation.Add(ValidationType.List, ValidationAlertStyle.Stop, ValidationOperator.Equal,"=$T$3#");
请注意,要获得动态数组函数的结果范围,单元格引用后跟一个#请注意,要获得动态数组函数的结果范围,单元格引用后跟一个#。
步骤 5 - 获取唯一 OrderID 列表(用于依赖下拉列表)
准备好主下拉列表后,让我们获取在主下拉列表中选择的客户名称的唯一 OrderID 列表。为此,请再次选择工作表中的任何单元格(在此示例中,此单元格为 $V$2)。在此单元格中使用以下公式获取所需的 OrderID 列表。
=CHOOSECOLS( FILTER( Unique_Cus_Order_combo, CHOOSECOLS(Unique_Cus_Order_combo,2)=CustomerName ), 1 )
公式解析如下:
定义 CustomerName是指包含主下拉列表的单元格的值;在此示例中,它指的是 =$L$3
定义的Unique_Cus_Order_combo是指订单 ID 和客户名称的唯一组合范围。它存储公式 =UNIQUE(data!$A$2:$B$2156),其中范围 A 和 B 分别包含 OrderID 和 Customer Names。
返回的数据部分如下图所示:
2.内部 CHOOSECOLS 函数提供由 Unique_Cus_Order_combo 表示的范围内的 Customer 名称列表,以便与 FILTER 函数中的 CustomerName 匹配。
3.FILTER函数从所选客户名称对应的Unique_Cus_Order_combo中筛选出数据,如下图所示:
4.最后,外部 CHOOSECOLS 函数从筛选的范围内返回所需的 OrderID 列表,如下所示:
要使用 GcExcel 设置定义的名称和动态公式,请按照以下示例代码进行操作:
workbook.Names.Add("CustomerName", "=$L$3"); workbook.Names.Add("Unique_Cus_Order_combo", "=UNIQUE(data!$A$2:$B$2156)"); IRange rngUniqueOrderIds; rngUniqueOrderIds = worksheet.Range["V2"]; //dummy range to get unique list of customer names rngUniqueOrderIds.Formula2 = "=CHOOSECOLS(FILTER(Unique_Cus_Order_combo, CHOOSECOLS(Unique_Cus_Order_combo,2)=CustomerName), 1)";
步骤 6 - 填充依赖下拉列表
下一步是使用上一步中提取的列表填充 OrderID 下拉列表(在此示例中,它位于 L6)。为此,请添加类型列表的数据验证(与为主下拉列表添加的数据验证相同),并将其源值设置为包含上一步中公式的单元格值(即 =$V$2)前缀为 #。
IValidation orderIdList = worksheet.Range["L6"].Validation; orderIdList.Add(ValidationType.List, ValidationAlertStyle.Stop, ValidationOperator.Equal, "=$v$2#");
步骤 7 - 将默认值设置为下拉列表并保存工作簿
最后,使用 IRange 接口的 API将默认值设置为下拉列表,并使用 IWorkbook 接口的 API保存工作簿,如下面的代码片段所示:
worksheet.Range["L3"].Value = "Paul Henriot"; worksheet.Range["L6"].Value = 10248; workbook.Save("E:\\download\\smartdependentlist\\CustomerOrderHistoryReport.xlsx");
生成的带有智能依赖列表的 Excel 文件如下图所示:
到此这篇关于C#使用Excel动态函数实现生成依赖列表的文章就介绍到这了,更多相关C# Excel动态函数生成依赖列表内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
最新评论