PivotCacheDefinition 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

PivotCache 定义。

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

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

public class PivotCacheDefinition : DocumentFormat.OpenXml.OpenXmlPartRootElement

type PivotCacheDefinition = class
    inherit OpenXmlPartRootElement

Public Class PivotCacheDefinition
Inherits OpenXmlPartRootElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

OpenXmlPartRootElement

PivotCacheDefinition

注解

[ISO/IEC 29500-1 第 1 版]

pivotCacheDefinition (PivotCache 定义)

表示 pivotCacheDefinition 部件。 此部分定义源数据中的每个字段，包括名称、共享项) 的实例数据 (的字符串资源，以及有关字段中出现的数据类型的信息。

[示例：

<pivotCacheDefinition xmlns="…" xmlns:r="…" r:id="rId1" refreshedBy="AnonUser"  refreshedDate="2006-05-22T10:07:16Z" createdVersion="3" refreshedVersion="3"   minRefreshableVersion="3" recordCount="182">  
  <cacheSource type="worksheet">  
    <worksheetSource name="Table1"/>  
  </cacheSource>  
  <cacheFields count="28">  
    <cacheField name="Customer Name" numFmtId="0">  
    <cacheField name="Postal Code" numFmtId="0">  
      <sharedItems/>  
    </cacheField>  
    <cacheField name="Product Category" numFmtId="0">  
      <sharedItems count="1">  
        <s v="Bikes"/>  
      </sharedItems>  
    </cacheField>  
    <cacheField name="Year" numFmtId="0">  
      <sharedItems count="1">  
        <s v="2001"/>  
      </sharedItems>  
    </cacheField>  
    <cacheField name="Quarter" numFmtId="0">  
      <sharedItems containsSemiMixedTypes="0" containsString="0"         containsNumber="1" containsInteger="1" minValue="3" maxValue="3"         count="1">  
        <n v="3"/>  
      </sharedItems>  
    </cacheField>  
  </cacheField  
s>  
</pivotCacheDefinition>  

示例结束]

父元素
SpreadsheetML 数据透视表缓存定义部件的根元素

子元素	第
cacheFields (PivotCache Fields)	§18.10.1.4
cacheHierarchies (PivotCache 层次结构)	§18.10.1.5
cacheSource (PivotCache 源说明)	§18.10.1.7
calculatedItems (计算项)	§18.10.1.9
calculatedMembers (计算成员)	§18.10.1.11
维度 (OLAP 维度)	§18.10.1.25
extLst (Future Feature Data Storage Area)	§18.2.10
kpis (OLAP KPI)	§18.10.1.48
映射 (OLAP 度量值组)	§18.10.1.52
measureGroups (OLAP 度量值组)	§18.10.1.54
tupleCache (元组缓存)	§18.10.1.94

属性	说明
backgroundQuery (后台查询)	指定一个布尔值，该值指示应用程序是否应从缓存异步查询和检索记录。 值为 1 或 true 表示应用程序将从缓存中异步检索记录。 值为 0 或 false 表示应用程序将同步检索记录。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
createdVersion (PivotCache Created Version)	指定创建缓存的应用程序的版本。 此属性依赖于应用程序。 此属性的可能值由 W3C XML 架构 unsignedByte 数据类型定义。
enableRefresh (启用 PivotCache 刷新)	指定一个布尔值，该值指示最终用户是否可以刷新缓存。 此属性取决于应用程序是否公开允许最终用户通过用户界面控制刷新缓存的方法。 值为 1 或 true 表示最终用户可以刷新缓存。 值为 0 或 false 表示最终用户无法刷新缓存。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
id (关系标识符) 命名空间： .../officeDocument/2006/relationships	指定与相关 pivotCacheRecords 部件对应的唯一标识符。 有关详细信息，请参阅 (§18.10.1.68) 。 此属性的可能值由 ST_RelationshipId 简单类型 (§22.8.2.1) 定义。
无效 (无效的缓存)	指定一个布尔值，该值指示是否需要刷新缓存。 值为 1 或 true 表示需要刷新缓存。 值为 0 或 false 表示不需要刷新缓存。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
minRefreshableVersion (刷新) 所需的最低版本	指定刷新缓存所需的应用程序的最早版本。 此属性依赖于应用程序。 此属性的可能值由 W3C XML 架构 unsignedByte 数据类型定义。
missingItemsLimit (缺少项限制)	指定在放弃未使用的项目之前允许的未使用项数。 此属性依赖于应用程序。 应用程序应指定未使用的项的阈值。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
optimizeMemory (针对内存) 优化缓存	指定一个布尔值，该值指示应用程序是否对缓存应用优化以减少内存使用量。 此属性依赖于应用程序。 此应用程序应定义自己的缓存优化方法。 应用程序还应决定是通过用户界面还是对象模型公开缓存优化状态。 值为 1 或 true 表示应用程序将对缓存应用优化。 值为 0 或 false 表示应用程序不会对缓存应用优化。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
recordCount (PivotCache Record Count)	指定缓存中的记录数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
refreshedBy (上次刷新)	指定上次刷新缓存的最终用户的名称。 此属性依赖于应用程序，由跟踪和存储当前用户标识的应用程序指定。 此属性还取决于应用程序是否通过用户界面公开机制，最终用户可以通过该用户界面刷新缓存。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
refreshedDateIso (PivotCache 上次刷新日期 ISO)	指定上次刷新缓存的日期。 此属性取决于应用程序是否通过用户界面公开机制，最终用户可以通过该用户界面刷新缓存。 如果 refreshedDateIso 和 refreshedDate 都存在，则 refreshedDateIso 应优先。 此属性的可能值由 W3C XML Schema dateTime 数据类型定义。
refreshedVersion (PivotCache 上次刷新的版本)	指定上次刷新缓存的应用程序版本。 此属性取决于应用程序是否通过用户界面公开机制，最终用户可以通过该用户界面刷新缓存。 此属性的可能值由 W3C XML 架构 unsignedByte 数据类型定义。
refreshOnLoad (加载时刷新)	指定一个布尔值，该值指示在打开工作簿时应用程序是否会刷新缓存。 值为 1 或 true 表示应用程序将在加载工作簿时刷新缓存。 值为 0 或 false 表示应用程序不会自动刷新缓存的数据。 最终用户应通过应用程序用户界面手动触发缓存刷新。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
saveData (保存数据透视记录)	指定一个布尔值，该值指示是否随缓存一起保存透视记录。 值为 1 或 true 表示透视记录保存在缓存中。 值为 0 或 false 表示缓存中未保存。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
supportAdvancedDrill (支持属性向下钻取)	指定缓存的数据源是否支持属性向下钻取。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
supportSubquery (支持子查询)	指定缓存的数据源是否支持子查询。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
tupleCache (存储用于 OLAP Functions 的缓存)	指定一个布尔值，该值指示是否使用 PivotCache 存储 OLAP 工作表数据函数的信息。 值为 1 或 true 表示有关 OLAP 工作表数据函数的信息存储在缓存中。 值为 0 或 false 表示 PivotCache 不包含有关 OLAP 工作表数据函数的信息。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
upgradeOnRefresh (刷新时升级 PivotCache)	指定一个布尔值，该值指示缓存是否计划进行版本升级。 此属性取决于应用程序是否通过用户界面公开机制，从而可以升级缓存。 值为 1 或 true 表示缓存已计划升级。 值为 0 或 false 表示缓存未计划升级。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。

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

ISO/IEC29500：2008。

构造函数

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

属性

BackgroundQuery	backgroundQuery 表示架构中的以下属性：backgroundQuery
CacheFields	CacheFields。 表示架构中的以下元素标记：x：cacheFields。
CacheHierarchies	CacheHierarchies。 表示架构中的以下元素标记：x：cacheHierarchies。
CacheSource	CacheSource。 表示架构中的以下元素标记：x：cacheSource。
CalculatedItems	CalculatedItems。 表示架构中的以下元素标记：x：calculatedItems。
CalculatedMembers	CalculatedMembers。 表示架构中的以下元素标记：x：calculatedMembers。
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
CreatedVersion	createdVersion 表示架构中的以下属性：createdVersion
Dimensions	尺寸。 表示架构中的以下元素标记：x：dimensions。
EnableRefresh	enableRefresh 表示架构中的以下属性：enableRefresh
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
Id	id 表示架构中的以下属性：r：id
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
Invalid	无效 表示架构中的以下属性：无效
IsTupleCache	tupleCache 表示架构中的以下属性：tupleCache
Kpis	Kpi。 表示架构中的以下元素标记：x：kpis。
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
LastRefreshedDateIso	refreshedDateIso 表示架构中的以下属性：refreshedDateIso
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
Maps	映射。 表示架构中的以下元素标记：x：maps。
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
MeasureGroups	MeasureGroups。 表示架构中的以下元素标记：x：measureGroups。
MinRefreshableVersion	minRefreshableVersion 表示架构中的以下属性：minRefreshableVersion
MissingItemsLimit	missingItemsLimit 表示架构中的以下属性：missingItemsLimit
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OpenXmlPart	获取与 DOM 树关联的部分。 当 DOM 树未与部件关联时，它返回 null。 (继承自 OpenXmlPartRootElement)
OptimizeMemory	optimizeMemory 表示架构中的以下属性：optimizeMemory
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
PivotCacheDefinitionExtensionList	PivotCacheDefinitionExtensionList。 表示架构中的以下元素标记：x：extLst。
PivotTableCacheDefinitionPart	获取与此元素关联的 PivotTableCacheDefinitionPart。
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
RecordCount	recordCount 表示架构中的以下属性：recordCount
RefreshedBy	refreshedBy 表示架构中的以下属性：refreshedBy
RefreshedDate	refreshedDate 表示架构中的以下属性：refreshedDate
RefreshedVersion	refreshedVersion 表示架构中的以下属性：refreshedVersion
RefreshOnLoad	refreshOnLoad 表示架构中的以下属性：refreshOnLoad
SaveData	saveData 表示架构中的以下属性：saveData
SupportAdvancedDrill	supportAdvancedDrill 表示架构中的以下属性：supportAdvancedDrill
SupportSubquery	supportSubquery 表示架构中的以下属性：supportSubquery
TupleCache	TupleCache。 表示架构中的以下元素标记：x：tupleCache。
UpgradeOnRefresh	upgradeOnRefresh 表示架构中的以下属性：upgradeOnRefresh
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(PivotTableCacheDefinitionPart)	从 PivotTableCacheDefinitionPart 加载 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(PivotTableCacheDefinitionPart)	将 DOM 保存到 PivotTableCacheDefinitionPart 中。
Save(Stream)	将 DOM 树保存到指定的流。 (继承自 OpenXmlPartRootElement)
SetAttribute(OpenXmlAttribute)	将特性设置为指定的元素。 如果该属性是已知属性，则设置该特性的值。 如果该属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	设置元素的多个属性。 如果属性是已知属性，则会设置该属性的值。 如果属性是扩展属性，则会将“openxmlAttribute”添加到扩展属性列表中。 (继承自 OpenXmlElement)
WriteTo(XmlWriter)	将当前节点保存到指定的 XmlWriter。 (继承自 OpenXmlPartRootElement)

显式接口实现

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