com.zhuozhengsoft.pageoffice.excelreader
类 Sheet

java.lang.Object
  com.zhuozhengsoft.pageoffice.excelreader.Sheet

public class Sheet
extends java.lang.Object

Sheet 类，代表Excel中定义的工作表对象。

您只能通过调用 Workbook.openSheet(String) 方法获取 Sheet 对象。

版本：

2.0

作者：

北京卓正志远软件有限公司

方法摘要

java.util.ArrayList<Cell>	getCells() 获取控件提交的具有SubmitName命名的 Cell 集合。
java.lang.String	getName() 获取 Sheet 的名称。
java.util.ArrayList<Table>	getTables() 获取控件提交的具有SubmitName命名的 Table 集合。
Cell	openCell(java.lang.String name) 打开指定的单元格，并返回 Cell 对象。
Cell	openCellByDefinedName(java.lang.String definedName) 打开具有指定名称（Excel中定义的名称）的单元格，并返回 Cell 对象。
Table	openTable(java.lang.String name) 打开指定的表格，并返回 Table 对象。
Table	openTableByDefinedName(java.lang.String definedName) 打开具有指定名称（Excel中定义的名称）的表格，并返回 Table 对象。
Table	openTableBySubmitName(java.lang.String submitName)

从类 java.lang.Object 继承的方法

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

getName

public java.lang.String getName()
                         throws java.io.IOException

获取 Sheet 的名称。

抛出：

java.io.IOException

getCells

public java.util.ArrayList<Cell> getCells()
                                   throws java.io.IOException,
                                          java.lang.Exception

获取控件提交的具有SubmitName命名的 Cell 集合。

抛出：

java.io.IOException

java.lang.Exception

getTables

public java.util.ArrayList<Table> getTables()
                                     throws java.io.IOException,
                                            java.lang.Exception

获取控件提交的具有SubmitName命名的 Table 集合。

抛出：

java.io.IOException

java.lang.Exception

openCell

public Cell openCell(java.lang.String name)
              throws java.lang.Exception,
                     java.io.IOException

打开指定的单元格，并返回 Cell 对象。

下面的示例展示了如何调用 openCell 方法获取指定单元格的值。

 Workbook wb = new Workbook(request, response);
 Sheet sheet1 = wb.openSheet("sheet1");
 String strCompanyName = sheet1.openCell("CompanyName").getValue();
 String strProductName = sheet1.openCell("ProductName").getValue();
 String strProductCode = sheet1.openCell("ProductCode").getValue();
 
 //保存读取到的数据到数据库
 
 wb.close();
 

参数：

name - 可以是单元格引用字符串，例如："A1"。也可以是SubmitName，由开发者在打开文档时自由定义，一般命名为数据库里数据字段的名字，代码易于理解。请参考 com.zhuozhengsoft.pageoffice.excelwriter.Cell.SubmitName 属性学习如何给Cell定义一个 SubmitName。

SubmitName 对大小写敏感。

返回：

返回 Cell 对象。

抛出：

java.lang.Exception

java.io.IOException

另请参见：

Cell.setSubmitName()方法中的示例代码。

openCellByDefinedName

public Cell openCellByDefinedName(java.lang.String definedName)
                           throws java.lang.Exception,
                                  java.io.IOException

打开具有指定名称（Excel中定义的名称）的单元格，并返回 Cell 对象。

参数：

definedName - 在Excel中定义的名称，可以是全局名称，也可以是局部名称。必须在打开文档时打开DefinedName命名的Cell，这里才会生效。

返回：

返回 Cell 对象。

抛出：

java.lang.Exception

java.io.IOException

openTable

public Table openTable(java.lang.String name)
                throws java.lang.Exception,
                       java.io.IOException

打开指定的表格，并返回 Table 对象。

下面的示例展示了如何调用 openCell 方法获取指定单元格的值。

 Workbook wb = new Workbook(request, response);
 Sheet sheet1 = wb.openSheet("sheet1");
 //获取单元格的值
 String strCompanyName = sheet1.openCell("CompanyName").getValue();
 //获取表格的数据
 Table table1 = sheet1.openTable("SalesInfo");
 while (!table1.getEOF()){
                String strValues = "";
                if (!table1.getDataFields().getIsEmpty()){
                        for (int i = 0; i < table1.getDataFields().size(); i++)
                                strValues = strValues + table1.getDataFields().get(i).getValue() + "&nbsp;&nbsp;";
                        // 把获取到的数据直接输出到当前保存页，在下面 showPage 弹出的对话框里显示保存结果
                        out.println(strValues + "<br>\r\n");
                }
                table1.nextRow();
 }
 table1.close();
 out.println("table1.RowCount = " + table1.getRowCount());
 wb.showPage(800, 600); // 保存成功后弹出对话框显示获取的表格数据
 wb.close();
 

参数：

submitName - 由开发者在打开文档时自由定义，一般命名为数据库里数据表的名字，代码易于理解。请参考 com.zhuozhengsoft.pageoffice.excelwriter.Table.SubmitName 属性学习如何给Table定义一个 SubmitName。

SubmitName 对大小写敏感。

返回：

返回 Table 对象。

抛出：

java.lang.Exception

java.io.IOException

另请参见：

Table.setSubmitName()方法中的示例代码。

openTableBySubmitName

public Table openTableBySubmitName(java.lang.String submitName)
                            throws java.lang.Exception,
                                   java.io.IOException

抛出：

java.lang.Exception

java.io.IOException

openTableByDefinedName

public Table openTableByDefinedName(java.lang.String definedName)
                             throws java.lang.Exception,
                                    java.io.IOException

打开具有指定名称（Excel中定义的名称）的表格，并返回 Table 对象。

参数：

definedName - 在Excel中定义的名称，可以是全局名称，也可以是局部名称。必须在打开文档时打开DefinedName命名的Table，这里才会生效。

返回：

返回 Table 对象。

抛出：

java.lang.Exception

java.io.IOException