workbook 中常用属性之 sheets

新建子表

子表在 ooxml 中的结构如下所示：

<sheets>
    <sheet name="工作表1" sheetId="1" r:id="rId1"/>
    <sheet name="Sheet1" sheetId="2" r:id="rId2"/>
</sheets>

sheet 的常用属性介绍

name

子表的名称， 不能重复，字符串类型。如果重复的话就会报如下的错误。

sheetId

sheetId 一个整数值，表示工作表的唯一ID。此ID用于在工作簿内部唯一标识工作表。注意，sheetId并不一定与工作表在工作簿中的顺序相对应。

state

state 属性是可选的， 字符串枚举类型。 可能的取值有以下几个：

• visible: 工作表可见， 默认值。
• hidden: 工作表被隐藏，但可以通过Excel的“取消隐藏”功能重新显示。
• veryHidden: 工作表被隐藏， 且无法通过Excel的“取消隐藏”功能重新显示。要访问这种工作表，需要使用VBA或其他编程方法。

r:id

字符串类型，表示工作表与工作簿之间的关系ID。此ID用于在关系文件（.rels）中查找工作表的实际文件位置。例如，r:id="rId1"可能表示工作表文件位于xl/worksheets/sheet1.xml。

比如如下的 workbook.xml.rels 文件：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
  <Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" Target="theme/theme1.xml"/>
  <Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet2.xml"/>
  <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet1.xml"/>
  <Relationship Id="rId4" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/>
</Relationships>

从这个文件中可以看到， rId1 的 worksheet 的情况， 比如 Target 表示文件存放的路径。

sheet 除了上面的属性， 还有很多的子标签属性， 比如 sheet 的数据， 标签颜色等等。 这个我们会放在单独的 sheet 的常见属性里面讲解。