SubmitName
设置 Cell 的 SubmitName。
SubmitName 用来标记当前 Cell 对象在控件保存时需要被提交到 SaveDataPage 服务器页面。只有当您需要提交当前 Cell 中的数据时,才需要定义 SubmitName。 如果您定义了SubmitName,当保存文档时,此 SubmitName 将被作为 PageOffice.ExcelReader.Sheet.openCell(string) 方法的参数来获取指定的 Cell 对象。 如果您使用的文档打开模式是OpenModeType.xlsSubmitForm,并且当前Cell对象定义了SubmitName,那么此单元格会自动处于可编辑状态。如果此时您需要将单元格设为只读,只要给当前Cell的 ReadOnly 属性赋值true就可以了。
语法:
public string SubmitName { get; set; }
SubmitName 由开发者自由定义,一般命名为数据库里数据字段的名字,代码易于理解。这里定义的SubmitName在文档保存时将被用作 PageOffice.ExcelReader.Sheet.OpenCell(string) 方法的参数。 SubmitName 在同一个Sheet里应该保持唯一。SubmitName 对大小写敏感。
示例:
下面的示例展示了如何定义需要提交的Cell。
PageOffice.ExcelWriter.Workbook wb = new PageOffice.ExcelWriter.Workbook();
PageOffice.ExcelWriter.Sheet sheet1 = wb.OpenSheet("sheet1");
sheet1.OpenCell("C1").Value = "卓正软件"; // 此单元格不会提交
sheet1.OpenCell("C2").Value = ""; // 初始化单元格的值
sheet1.OpenCell("C2").SubmitName = "CompanyName"; // 此单元格需要提交
sheet1.OpenCell("D2").SubmitName = "ProductName"; // 此单元格需要提交
sheet1.OpenCellRC(2, 5).SubmitName = "ProductCode"; // 此单元格需要提交
POCtrl.SaveDataPage = "savadata.aspx";
POCtrl.SetWriter(wb);
POCtrl.WebOpen("doc/test.xls", PageOffice.OpenModeType.xlsSubmitForm, "张三");