PivotSelection 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

数据透视表选择。

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

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

public class PivotSelection : DocumentFormat.OpenXml.OpenXmlCompositeElement

type PivotSelection = class
    inherit OpenXmlCompositeElement

Public Class PivotSelection
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

PivotSelection

注解

[ISO/IEC 29500-1 第 1 版]

pivotSelection (PivotTable Selection)

数据透视表结构选择的集合。 数据透视表结构选择是指定在数据透视表中选择哪些单元格的方法。 指定数据透视表中的特定区域或结构，而不是在 sqref 中指定单元格地址。 这样，所选内容就具有语义意义，而不仅仅是选定内容中包含的单元格或区域列表。 通常选择行轴或列轴上的字段。

[示例：例如，在此数据透视表中选择了 product SubCategory) (最内部的字段：

69bf0087-c567-4d34-88db-014e53f7bae8

相应的透视表Selection XML 应如下所示：

<pivotSelection pane="bottomRight" showHeader="1" axis="axisRow" dimension="2"  activeRow="11" activeCol="1" previousRow="11" previousCol="1" click="1"   r:id="rId1">  
  <pivotArea dataOnly="0" labelOnly="1" fieldPosition="0">  
    <references count="1">  
      <reference field="9" count="0"/>  
    </references>  
  </pivotArea>  
</pivotSelection>  

axis 指示此选定内容位于行轴上，维度指示 (从零开始的索引) 选择的行轴内的字段级别，activeCol 和 activeRow 分别指示选定内容在网格中的位置，引用字段指示所选内容对应于哪个特定字段。

示例结束]

父元素
sheetView (§18.3.1.87)

子元素	第
pivotArea (Pivot Area)	§18.3.1.68

属性	说明
activeCol (活动列)	用于结构选择的活动单元格的列 (从零开始的) 。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
activeRow (活动行)	用于结构选择的活动单元格的行 (从零开始的) 。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
轴 (轴)	此选定内容所在的数据透视表的轴。 此属性的可能值由 ST_Axis 简单类型 (§18.18.1) 定义。
单击 (单击计数)	此结构选择的单击次数。 对于某些选择组合，后续单击同一目标区域会通过一些方差来循环实际选择。 因此，如果需要在加载时还原选择周期的此状态，则应记录对所选内容的单击次数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
count (Selection Count)	结构选择的选择数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
数据 (数据选择)	指示结构选择是否仅用于数据的标志。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
维度 (维度)	指示 (从零开始的索引) 选择的轴内的字段级别。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
extendable (Extendable)	指示结构选择是否可以添加其他选择的标志。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
id (关系 ID) 命名空间： .../officeDocument/2006/relationships	指向对应于此选择的特定数据透视表部件的关系 ID。 此属性的可能值由 ST_RelationshipId 简单类型 (§22.8.2.1) 定义。
标签 (标签)	指示结构选择是否仅针对标签 (的标志，例如，) 选择了总计行。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
最大 ()	结构选择包含的最大行。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
min (minimum)	结构选择包含的最小行。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
窗格 (窗格)	此数据透视表结构选择所属的窗格。 此属性的可能值由 ST_Pane 简单类型 (§18.18.52) 定义。
previousCol (上一列选择)	结构选择的列的索引为 1。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
previousRow (上一行)	结构选择正上方的行的索引为 1。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
showHeader (显示标头)	指示是否启用从数据到仅对两者进行标头切换的选择的标志。 False 表示已禁用。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
start (Start)	结构选择从零开始 (行) 。 这是单击以启动结构选择的行。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。

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

ISO/IEC29500：2008。

构造函数

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

属性

ActiveColumn	活动列 表示架构中的以下属性：activeCol
ActiveRow	活动行 表示架构中的以下属性：activeRow
Axis	Axis 表示架构中的以下属性：axis
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
Click	单击计数 表示架构中的以下属性：单击
Count	选择计数 表示架构中的以下属性：count
Data	数据选择 表示架构中的以下属性：data
Dimension	Dimension 表示架构中的以下属性：维度
Extendable	扩展 表示架构中的以下属性：extendable
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
Id	关系 ID 表示架构中的以下属性：r：id
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
Label	标签 表示架构中的以下属性：标签
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
Max	最高 表示架构中的以下属性：max
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
Min	最小值 表示架构中的以下属性： min
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Pane	Pane 表示架构中的以下属性：窗格
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
PivotArea	透视区域。 表示架构中的以下元素标记：x：pivotArea。
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
PreviousColumn	上一列选择 表示架构中的以下属性：previousCol
PreviousRow	上一行 表示架构中的以下属性：previousRow
ShowHeader	显示标头 表示架构中的以下属性：showHeader
Start	开始 表示架构中的以下属性：start
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)
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)
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)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

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