Table 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

表。

此类在 Office 2007 及更高版本中可用。

当对象序列化为 xml 时，其限定名称为 x：table。

public class Table : DocumentFormat.OpenXml.OpenXmlPartRootElement

type Table = class
    inherit OpenXmlPartRootElement

Public Class Table
Inherits OpenXmlPartRootElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

OpenXmlPartRootElement

Table

注解

[ISO/IEC 29500-1 第 1 版]

table (Table)

此元素是不是单个单元格 XML 表的表的根元素。

父元素
SpreadsheetML 表定义部分的根元素

子元素	第
autoFilter (AutoFilter Settings)	§18.3.1.2
extLst (Future Feature Data Storage Area)	§18.2.10
sortState (排序状态)	§18.3.1.92
tableColumns (表列)	§18.5.1.4
tableStyleInfo (表样式)	§18.5.1.5

属性	说明
注释 (表注释)	表示有关表的文本注释的字符串。 [注意：这可由其他 UI 中的电子表格应用程序使用。 结束注释][示例：可能有用于组织已定义名称和函数引用的名称 UI，如果该 UI 中列出了表，则注释可以提供有关表的详细信息。 示例结束] 此字符串的最大长度应为 32767 个字符。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
connectionId (连接 ID)	表示 ID 的整数，指示此表使用来自连接集合中的哪个连接。 这只能用于基于 xml 映射的表。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
dataCellStyle (数据样式名称)	一个字符串，表示应用于表的数据区域单元格的单元格样式的名称。 如果此字符串缺失或与单元格样式的名称不对应，则应应用由当前表样式指定的数据单元格样式。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
dataDxfId (数据区域格式 ID)	从零开始的整数索引到差异格式设置中记录 <styleSheet 中的 dxfs> ，指示要应用于此表的数据区域的格式。 如果此索引超出边界，电子表格应无法加载。 此属性的可能值由 ST_DxfId 简单类型 (§18.18.25) 定义。
displayName (表名称)	表示表名称的字符串。 这是应在公式引用中使用的名称，并在 UI 中显示给电子表格用户。 此名称中不得包含任何空格，并且该名称在工作簿中的所有其他 displayNames 和 definedNames 中应是唯一的。 字符长度和限制与 definedNames 相同。 有关详细信息，请参阅 SpreadsheetML 参考 - 工作簿定义名称 部分 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
headerRowBorderDxfId (标题行边框格式 ID)	差异格式设置中的从零开始的整数索引记录 <styleSheet 中的 dxfs> ，指示要应用于此表的标题行的边框格式。 如果此索引超出边界，电子表格应无法加载。 此属性的可能值由 ST_DxfId 简单类型 (§18.18.25) 定义。
headerRowCellStyle (标题行样式)	一个字符串，表示应用于表格的标题行单元格的单元格样式的名称。 如果此字符串缺失或与单元格样式的名称不对应，则应应用当前表格样式指定的标题行样式。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
headerRowCount (标头行计数)	一个整数，表示表顶部显示的标题行数。 0 表示不显示标题行。 是否允许大于 1 的数字由电子表格应用程序决定。 除非电子表格应用程序具有可能有多个标题行的功能，否则此数字不应大于 1。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
headerRowDxfId (标头行格式 ID)	styleSheet 中差异格式记录 *<dxfs>*的从零开始的整数索引，指示要应用于此表的标题行的格式。 如果此索引超出边界，电子表格应无法加载。 此属性的可能值由 ST_DxfId 简单类型 (§18.18.25) 定义。
id (表 ID)	表示此表的唯一标识符的非零整数。 工作簿中的每个表应具有唯一 ID。 ID 可用于引用工作簿中的特定表。 [注意：例如，将来的记录存储桶可以使用此 ID 引用表。 尾注] 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
insertRow (显示) 的插入行	指示是否显示插入行的布尔值。 显示插入行时为 True，否则为 false。 仅当表没有数据时，才应显示插入行。 当用户单击 UI 中的插入行时，这为他们提供了将数据输入表中的简单方法。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
insertRowShift (插入行移位)	一个布尔值，指示在显示此表的插入行时是否必须插入工作表中的单元格。 如果单元格已移动，则为 True;否则为 false。 [注意：当创建表并显示插入行时，表正下方的单元格中存在值时，就会发生这种情况。 在这种情况下，插入行的空白单元格，工作表中的现有值向下移动一行以腾出空间。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
name (Name)	表示表名称的字符串，用于通过电子表格应用程序对象模型以编程方式引用表。 此字符串应对每张表是唯一的。 它具有与 displayName 相同的长度和字符限制。 默认情况下，这应与表的 displayName 相同。 当电子表格用户在 UI 中更新 displayName 时，此名称也应与 displayName 保持同步。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
已发布 (已发布)	一个布尔值，表示此表是否标记为已发布以供基于服务器的电子表格应用程序查看。 如此 如果应该由服务器电子表格应用程序查看，否则为 false。 [注意：此类应用程序可能仅显示工作簿中标记为已发布的对象，因此能够加载和计算整个工作簿，但仅显示标记为已发布的特定项目。 这允许服务器电子表格呈现提供工作簿的更受限视图。 注释结束] 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
ref (参考)	使用 A1 样式引用表示的表所占用的相关工作表上的区域。 引用应包括总计行（如果显示）。 此属性的可能值由 ST_Ref 简单类型 (§18.18.62) 定义。
tableBorderDxfId (表边框格式 ID)	styleSheet 中差异格式设置记录 <dxfs> 的从零开始的整数索引，指示要应用于此表边框的边框格式。 如果此索引超出边界，电子表格应无法加载。 此属性的可能值由 ST_DxfId 简单类型 (§18.18.25) 定义。
tableType (表类型)	指定表的类型或源的可选枚举。 指示表是基于外部数据查询、工作表中的数据还是基于映射到工作表的 xml 数据。 此属性的可能值由 ST_TableType 简单类型 (§18.18.78) 定义。
totalsRowBorderDxfId (Totals 行边框格式 ID)	差异格式设置中的从零开始的整数索引记录 <styleSheet 中的 dxfs> ，指示要应用于此表的总计行的边框格式。 如果此索引超出边界，电子表格应无法加载。 此属性的可能值由 ST_DxfId 简单类型 (§18.18.25) 定义。
totalsRowCellStyle (Totals Row Style)	一个字符串，表示应用于表格的总计行单元格的单元格样式的名称。 如果此字符串缺失或与单元格样式的名称不对应，则应应用当前表格样式指定的总计行样式。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
totalsRowCount (Totals Row Count)	一个整数，表示应显示在表底部的总计行数。 0 表示不显示总计行。 是否允许大于 1 的数字由电子表格应用程序决定。 除非电子表格应用程序具有一个功能，即其可能不止一个总计行，否则此数字不应大于 1。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
totalsRowDxfId (Totals 行格式 ID)	差异格式设置中的从零开始的整数索引记录 <styleSheet 中的 dxfs> ，指示要应用于此表的总计行的格式。 如果此索引超出边界，电子表格应无法加载。 此属性的可能值由 ST_DxfId 简单类型 (§18.18.25) 定义。
totalsRowShown (Totals Row Shown)	一个布尔值，指示过去是否为此表显示过总计行。 如果显示总计行，则为 True;否则为 false。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。

[注意：此元素的内容模型 (CT_Table) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]

ISO/IEC29500：2008。

构造函数

Table()	初始化 Table 类的新实例。
Table(IEnumerable<OpenXmlElement>)	使用指定的子元素初始化 Table 类的新实例。
Table(OpenXmlElement[])	使用指定的子元素初始化 Table 类的新实例。
Table(String)	从外部 XML 初始化 Table 类的新实例。

属性

AutoFilter	表自动筛选。 表示架构中的以下元素标记：x：autoFilter。
BorderFormatId	表格边框格式 ID 表示架构中的以下属性：tableBorderDxfId
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
Comment	表注释 表示架构中的以下属性：注释
ConnectionId	连接 ID 表示架构中的以下属性：connectionId
DataCellStyle	数据样式名称 表示架构中的以下属性：dataCellStyle
DataFormatId	数据区域格式 ID 表示架构中的以下属性：dataDxfId
DisplayName	表名称 表示架构中的以下属性：displayName
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
HeaderRowBorderFormatId	标题行边框格式 ID 表示架构中的以下属性：headerRowBorderDxfId
HeaderRowCellStyle	标题行样式 表示架构中的以下属性：headerRowCellStyle
HeaderRowCount	标题行计数 表示架构中的以下属性：headerRowCount
HeaderRowFormatId	标题行格式 ID 表示架构中的以下属性：headerRowDxfId
Id	表 ID 表示架构中的以下属性：id
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
InsertRow	插入显示行 表示架构中的以下属性：insertRow
InsertRowShift	插入行移位 表示架构中的以下属性：insertRowShift
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
Name	名称 表示架构中的以下属性：name
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OpenXmlPart	获取与 DOM 树关联的部分。 当 DOM 树未与部件关联时，它返回 null。 (继承自 OpenXmlPartRootElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
Published	Published 表示架构中的以下属性：已发布
Reference	参考 表示架构中的以下属性：ref
SortState	排序状态。 表示架构中的以下元素标记：x：sortState。
TableColumns	表列。 表示架构中的以下元素标记：x：tableColumns。
TableDefinitionPart	获取与此元素关联的 TableDefinitionPart。
TableExtensionList	未来特征数据存储区域。 表示架构中的以下元素标记：x：extLst。
TableStyleInfo	表样式。 表示架构中的以下元素标记：x：tableStyleInfo。
TableType	表类型 表示架构中的以下属性：tableType
TotalsRowBorderFormatId	总计行边框格式 ID 表示架构中的以下属性：totalsRowBorderDxfId
TotalsRowCellStyle	总计行样式 表示架构中的以下属性：totalsRowCellStyle
TotalsRowCount	总计行计数 表示架构中的以下属性：totalsRowCount
TotalsRowFormatId	总计行格式 ID 表示架构中的以下属性：totalsRowDxfId
TotalsRowShown	显示的总计行 表示架构中的以下属性：totalsRowShown
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	如果指定元素是已知的子元素，则将其添加到 元素。 这会根据架构将 元素添加到正确的位置。 (继承自 OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	将命名空间声明添加到当前节点。 (继承自 OpenXmlElement)
Ancestors()	枚举当前元素的所有上级。 (继承自 OpenXmlElement)
Ancestors<T>()	仅枚举具有指定类型的当前元素的上级。 (继承自 OpenXmlElement)
Annotation(Type)	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotation<T>()	从当前 OpenXmlElement 元素获取指定类型的第一个批注对象。 (继承自 OpenXmlElement)
Annotations(Type)	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Annotations<T>()	获取具有当前 OpenXmlElement 元素的指定类型的批注的集合。 (继承自 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	将元素列表中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
Append(OpenXmlElement[])	将元素数组中的每个元素追加到当前元素的子元素列表的末尾。 (继承自 OpenXmlElement)
AppendChild<T>(T)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlCompositeElement)
ClearAllAttributes()	清除所有属性，包括已知属性和扩展属性。 (继承自 OpenXmlElement)
Clone()	创建当前节点的副本。 (继承自 OpenXmlElement)
CloneNode(Boolean)	创建此节点的副本。
Descendants()	枚举当前元素的所有后代。 (继承自 OpenXmlElement)
Descendants<T>()	枚举类型为 T 的当前元素的所有后代。 (继承自 OpenXmlElement)
Elements()	枚举当前元素的所有子元素。 (继承自 OpenXmlElement)
Elements<T>()	仅枚举具有指定类型的当前元素的子元素。 (继承自 OpenXmlElement)
ElementsAfter()	枚举与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
ElementsBefore()	枚举当前元素之前且具有与当前元素相同的父级的所有同级元素。 (继承自 OpenXmlElement)
GetAttribute(String, String)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 OpenXmlElement)
GetAttributes()	获取一个列表，该列表包含所有属性的副本。 (继承自 OpenXmlElement)
GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)
GetFirstChild<T>()	查找类型 T 中的第一个子元素。 (继承自 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素的指定索引处插入指定的元素。 (继承自 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	将指定的元素紧接在当前元素的前面。 (继承自 OpenXmlElement)
IsAfter(OpenXmlElement)	确定当前元素是否以文档顺序显示在指定元素之后。 (继承自 OpenXmlElement)
IsBefore(OpenXmlElement)	确定当前元素是否按文档顺序显示在指定元素之前。 (继承自 OpenXmlElement)
Load(TableDefinitionPart)	从 TableDefinitionPart 加载 DOM
LookupNamespace(String)	解析当前节点上下文中的命名空间前缀。 (继承自 OpenXmlElement)
LookupPrefix(String)	查找当前元素范围内命名空间 URI 的相应前缀。 (继承自 OpenXmlElement)
NextSibling()	获取紧跟在当前 OpenXmlElement 元素后面的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子节点列表的开头插入指定的元素。 (继承自 OpenXmlCompositeElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Reload()	将部件内容重新加载到 Open XML DOM 树中。 此方法可以多次调用，每次调用它时，都会重新加载树，并放弃树上的先前更改。 (继承自 OpenXmlPartRootElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlCompositeElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	删除指定的子元素。 (继承自 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将当前元素的子元素之一替换为另一个 OpenXmlElement 元素。 (继承自 OpenXmlCompositeElement)
Save()	将 DOM 树中的数据保存回 部件。 此方法可以多次调用，每次调用时，都会刷新流。 (继承自 OpenXmlPartRootElement)
Save(Stream)	将 DOM 树保存到指定的流。 (继承自 OpenXmlPartRootElement)
Save(TableDefinitionPart)	将 DOM 保存到 TableDefinitionPart 中。
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlPartRootElement)

显式接口实现

IEnumerable.GetEnumerator()	表。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 x：table。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)