workbookTable 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示 Excel 表格。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | workbookTable 集合 | 获取 table 对象的集合。 |
| Add | WorkbookTable | 创建一个新表。 区域源地址确定将在其下添加表的工作表。 例如，如果无法 (添加表，因为地址无效，或者该表会与另一个表) 重叠，则会引发错误。 |
| Get | WorkbookTable | 读取 workbookTable 对象的属性和关系。 |
| 更新 | WorkbookTable | 更新 workbookTable 对象。 |
| 删除 | 无 | 删除表。 |
| List columns | workbookTableColumn 集合 | 获取 workbookTableColumn 对象的列表。 |
| 创建列 | WorkbookTableColumn | 通过发布到 columns 集合来创建新的 workbookTableColumn。 |
| List rows | workbookTableRow 集合 | 获取 workbookTableRow 对象集合。 |
| 创建行 | WorkbookTableRow | 通过发布到 rows 集合来创建新的 workbookTableRow。 |
| 获取数据正文范围 | workbookRange | 获取与表的数据正文关联的 workbookRange 对象。 |
| 获取标题行范围 | workbookRange | 获取与表的标题行关联的 workbookRange 对象。 |
| 获取表范围 | workbookRange | 获取与整个表关联的 workbookRange 对象。 |
| 获取总行范围 | workbookRange | 获取与表的 totals 行关联的 workbookRange 对象。 |
| 清除筛选器 | 无 | 清除当前表上应用的所有筛选器。 |
| 转换为范围 | workbookRange | 将表转换为普通单元格区域。 保留所有数据。 |
| 重新应用筛选器 | 无 | 重新应用当前表上的所有筛选器。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | string | 工作簿中表的唯一标识符。 即使表格已重命名，标识符值也仍保持不变。 此属性应解释为不透明的字符串值，不应分析为任何其他类型。 只读。 |
| name | string | 表的名称。 |
| showHeaders | 布尔值 | 指示标头行是否可见。 该值可以设置为显示或删除标头行。 |
| showTotals | 布尔值 | 指示总计行是否可见。 该值可以设置为显示或删除总计行。 |
| style | string | 表示表样式的常量值。 可能的值为： TableStyleLight1 通过 TableStyleLight21、 TableStyleMedium1 到 TableStyleMedium28、 TableStyleStyleDark1 通过 TableStyleStyleDark11。 还可以指定工作簿中显示的用户定义的自定义样式。 |
| highlightFirstColumn | Boolean | 指明第一列是否包含特殊格式。 |
| highlightLastColumn | Boolean | 指明最后一列是否包含特殊格式。 |
| showBandedColumns | Boolean | 指明列是否采用镶边格式来以不同的方式突出显示奇数列与偶数列，让表更易于阅读。 |
| showBandedRows | Boolean | 指明行是否采用镶边格式来以不同的方式突出显示奇数行与偶数行，让表更易于阅读。 |
| showFilterButton | Boolean | 指明是否在每个列标题的顶部显示筛选器按钮。 仅当 table 中包含标题行时，才允许设定此设置。 |
| legacyId | String | 旧版 Excel 客户端中使用的旧标识符。 即使表被重命名，标识符的值仍保持不变。 此属性应解释为不透明的字符串值，不应分析为任何其他类型。 只读。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| columns | workbookTableColumn 集合 | 表中所有列的列表。 此为只读属性。 |
| rows | workbookTableRow 集合 | 表中的所有行的列表。 此为只读属性。 |
| sort | WorkbookTableSort | 表的排序。 只读。 |
| worksheet | WorkbookWorksheet | 包含当前表格的工作表。 只读。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"highlightFirstColumn": true,
"highlightLastColumn": true,
"id": "String (identifier)",
"name": "String",
"showBandedColumns": true,
"showBandedRows": true,
"showFilterButton": true,
"showHeaders": true,
"showTotals": true,
"style": "String",
"legacyId": "String"
}