RangeSet 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

范围集。

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

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

public class RangeSet : DocumentFormat.OpenXml.OpenXmlLeafElement

type RangeSet = class
    inherit OpenXmlLeafElement

Public Class RangeSet
Inherits OpenXmlLeafElement

继承

Object

OpenXmlElement

OpenXmlLeafElement

RangeSet

注解

[ISO/IEC 29500-1 第 1 版]

rangeSet (Range Set)

表示 rangeSets 集合中的单个区域。 元素旨在通过合并具有要汇总的类似数据类别的 SpreadsheetML 范围来帮助创建数据透视表。 数据源的最简单布局是每个 rangeSets 的数据采用类似于列表的格式，第一行包含列标签，第一列包含行标签，其余行在同一行和列中具有类似项，并且范围内没有空白行或列。 特定 rangeSet 可以包含应用程序提供的内置命名区域、用户定义的命名区域、区域引用或对外部工作簿的引用。

使用此功能合并多个区域时，最多可以创建 4 个自定义报表筛选器 (也称为页面字段) ，通过专门启用在报表筛选器中选择一个或多个单独的区域来帮助筛选数据透视表。 对于创建的每个自定义页面字段，可以指定一个自定义标签并将其分配给参与合并范围的每个范围，以便可以按汇总的一个或多个区域筛选数据透视表。

[示例：考虑包含 6 个工作表的工作簿。 在 Sheet1 上，我们有：

00cfa900-e26c-47f7-af92-700036912181

在 Sheet2 上，我们有：

c6bee0fb-5844-4b3e-b9ed-403edbfcee23

… 以表 5 为上。

在 Sheet6 上，我们有由数据透视表汇总的合并范围，并且数据透视表存在两个页面筛选器。

8a269c06-dfb2-4f3a-8061-b81d3d1f02af

请注意，对于第二个页面筛选器，已为 Sheet1、Sheet2、...、Sheet5 数据源分别分配自定义标签“one”、“two”、“...”、“five”。 同样，已为 Sheet1、Sheet2、...、Shet5 数据源分别分配了自定义标签“1”、“2”、...、“5”。

表示这些自定义页面筛选器的 XML 必须如下所示：

<cacheSource type="consolidation">  
  <consolidation autoPage="0">  
    <pages count="2">  
      <page count="5">  
        <pageItem name="1"/>  
        <pageItem name="2"/>  
        <pageItem name="3"/>  
        <pageItem name="4"/>  
        <pageItem name="5"/>  
      </page>  
      <page count="5">  
        <pageItem name="one"/>  
        <pageItem name="two"/>  
        <pageItem name="three"/>  
        <pageItem name="four"/>  
        <pageItem name="five"/>  
      </page>  
    </pages>  
    <rangeSets count="5">  
      <rangeSet i1="0" i2="0" ref="A1:B3" sheet="Sheet1"/>  
      <rangeSet i1="1" i2="1" ref="A1:B3" sheet="Sheet2"/>  
      <rangeSet i1="2" i2="2" ref="A1:B3" sheet="Sheet3"/>  
      <rangeSet i1="3" i2="3" ref="A1:B3" sheet="Sheet4"/>  
      <rangeSet i1="4" i2="4" ref="A1:B3" sheet="Sheet5"/>  
    </rangeSets>  
  </consolidation>  
</cacheSource>  

示例结束]

[注意：属性 i1、i2、i3 和 i4 对应于在用户界面中创建的自定义页面字段。 电子表格 ML 仅支持 4 个自定义页面字段。 注释结束]

父元素
rangeSets (§18.10.1.80)

属性	说明
i1 (字段项索引第 1 页)	指定第一个页筛选器中页字段项的索引。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
i2 (字段项索引第 2 页)	指定第二页筛选器中页字段项的索引。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
i3 (字段项索引 第 3 页)	指定第三页筛选器中页字段项的索引。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
i4 (字段项索引第 4 页)	指定第四页筛选器中页字段项的索引。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
id (关系 ID) 命名空间： .../officeDocument/2006/relationships	指定存储范围集的工作簿部件的唯一标识符。 有关详细信息，请参阅工作簿 (§18.2) 。 此属性的可能值由 ST_RelationshipId 简单类型 (§22.8.2.1) 定义。
名称 (命名范围)	指定命名区域。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
ref (参考)	指定单元格区域。 此属性的可能值由 ST_Ref 简单类型 (§18.18.62) 定义。
工作表 (工作表名称)	指定工作表名称。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。

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

ISO/IEC29500：2008。

构造函数

RangeSet()

初始化 RangeSet 类的新实例。

属性

ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FieldItemIndexPage1	字段项索引第 1 页 表示架构中的以下属性：i1
FieldItemIndexPage2	字段项索引页 2 表示架构中的以下属性：i2
FieldItemIndexPage3	字段项索引第 3 页 表示架构中的以下属性：i3
FieldItemIndexPage4	字段项索引第 4 页 表示架构中的以下属性：i4
FirstChild	获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlLeafElement)
Id	关系 ID 表示架构中的以下属性：r：id
InnerText	获取或设置节点及其所有子级的串联值。 (继承自 OpenXmlElement)
InnerXml	获取或设置仅表示当前元素的子元素的标记。 (继承自 OpenXmlLeafElement)
LastChild	获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
Name	命名范围 表示架构中的以下属性：name
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
Reference	参考 表示架构中的以下属性：ref
Sheet	工作表名称 表示架构中的以下属性：sheet
XmlQualifiedName	获取当前元素的限定名称。 (继承自 OpenXmlElement)
XName	获取当前元素的限定名称。 (继承自 OpenXmlElement)

方法

AddAnnotation(Object)	将 对象添加到当前 OpenXmlElement 元素的批注列表中。 (继承自 OpenXmlElement)
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)	将指定的元素追加到当前元素的子节点列表的末尾。 (继承自 OpenXmlElement)
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)	在指定的引用元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAfterSelf<T>(T)	在当前元素之后立即插入指定的元素。 (继承自 OpenXmlElement)
InsertAt<T>(T, Int32)	在当前元素的子元素列表中指定索引处插入指定的元素。 (继承自 OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	将指定的元素紧接在指定的引用元素之前。 (继承自 OpenXmlElement)
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)	在当前元素的子元素列表的开头插入指定的元素。 (继承自 OpenXmlElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
Remove()	从其父元素中删除当前元素。 (继承自 OpenXmlElement)
RemoveAllChildren()	删除当前元素的所有子元素。 (继承自 OpenXmlLeafElement)
RemoveAllChildren<T>()	删除类型为 T 的当前元素的所有子元素。 (继承自 OpenXmlElement)
RemoveAnnotations(Type)	从当前 OpenXmlElement 元素中删除指定类型的注释。 (继承自 OpenXmlElement)
RemoveAnnotations<T>()	从当前 OpenXmlElement 元素中删除具有指定类型的批注。 (继承自 OpenXmlElement)
RemoveAttribute(String, String)	从当前元素中删除 属性。 (继承自 OpenXmlElement)
RemoveChild<T>(T)	从当前元素的子元素列表中删除指定的子元素。 (继承自 OpenXmlElement)
RemoveNamespaceDeclaration(String)	删除指定前缀的命名空间声明。 如果没有前缀，则不删除任何内容。 (继承自 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	将子元素替换为当前元素的子元素列表中的另一个子元素。 (继承自 OpenXmlElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlElement)

显式接口实现

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