CacheField 类

定义

命名空间:

DocumentFormat.OpenXml.Spreadsheet

程序集:

DocumentFormat.OpenXml.dll

包:

DocumentFormat.OpenXml v3.0.1

PivotCache 字段。

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

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

public class CacheField : DocumentFormat.OpenXml.OpenXmlCompositeElement

type CacheField = class
    inherit OpenXmlCompositeElement

Public Class CacheField
Inherits OpenXmlCompositeElement

继承

Object

OpenXmlElement

OpenXmlCompositeElement

CacheField

注解

[ISO/IEC 29500-1 第 1 版]

cacheField (PivotCache 字段)

表示 PivotCache 中的单个字段。 此定义包含有关字段的信息，例如字段的源、数据类型以及级别或层次结构中的位置。 sharedItems 元素在此字段中存储有关数据的其他信息。 如果没有共享项，则值直接存储在 pivotCacheRecords 部件中。

[示例：

<cacheField name="Group" numFmtId="0">  
  <sharedItems count="3">  
    <s v="Pacific"/>  
    <s v="North America"/>  
    <s v="Europe"/>  
  </sharedItems>  
</cacheField>  

示例结束]

父元素
cacheFields (§18.10.1.4)

子元素	第
extLst (Future Feature Data Storage Area)	§18.2.10
fieldGroup (字段组属性)	§18.10.1.30
mpMap (成员属性映射)	§18.10.1.58
sharedItems (共享项)	§18.10.1.90

属性	说明
描述文字 (PivotCache 字段标题)	指定缓存字段的描述文字。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
databaseField (Database Field)	指定一个布尔值，该值指示此字段是否来自源数据库，而不是由应用程序创建。 值为 1 或 true 表示字段来自源数据库。 值为 0 或 false 表示应用程序已创建字段。 [注意：此属性可用于定义的分组字段或计算字段。 在这种情况下，源数据库字段应位于定义的分组字段或计算字段之前。 注释结束] 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
公式 (计算字段公式)	指定计算字段的公式。 此公式由最终用户指定。 计算字段可以使用数据透视表中其他字段的内容来执行计算。 在为计算字段或计算项创建的公式中，可以像在其他工作表公式中一样使用运算符和表达式。 可以使用常量并引用数据透视表中的数据，但不能使用单元格引用或定义的名称。 不能使用需要单元格引用或定义名称的工作表函数作为参数，也不能使用数组函数。 进一步的行为和限制适用于计算字段的公式： - 计算字段的公式基于公式中任何字段的基础数据的总和。 [示例：公式 =Sales * 1.2 将每种类型和区域的销售额总和乘以 1.2;它不会将每个单个销售额乘以 1.2，然后求和乘数。 示例结束] - 公式不能引用总计。 有关公式的详细信息，请参阅公式中的 §18.17。 有关定义的名称的详细信息，请参阅工作簿中的 §18.2.6。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
hierarchy (Hierarchy)	指定此字段所属的层次结构。 此属性的可能值由 W3C XML 架构 int 数据类型定义。
级别 (层次结构级别)	指定此字段所属的层次结构级别。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
mappingCount (成员属性计数)	指定此字段的属性映射数。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
memberPropertyField (成员属性字段)	指定一个布尔值，该值指示字段是否包含 OLAP 成员属性信息。 值为 1 或 true 表示此字段包含 OLAP 成员属性信息。 值为 0 或 false 表示此字段不包含 OLAP 成员属性信息。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
name (PivotCache 字段名称)	指定缓存字段的名称。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
numFmtId (数字格式 ID)	指定应用于字段中所有项的数字格式。 数字格式写入样式部分。 有关详细信息，请参阅样式中的 §18.8.31。 [注意：单元格表和数据透视表提供的格式设置信息不需要达成一致。 如果这两种格式不同，则单元格级格式优先。 如果更改数据透视表的布局，则数据透视表格式将优先。 注释结束] 此属性的可能值由 ST_NumFmtId 简单类型 (§18.18.47) 定义。
propertyName (属性名称)	如果此字段是 OLAP 属性字段，则指定属性的名称。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。
serverField (基于服务器的字段)	指定一个布尔值，该值指示字段是否是基于服务器的页字段。 值为 1 或 true 表示此字段是基于服务器的页字段。 值为 0 或 false 表示此字段不是基于服务器的页字段。 此属性仅适用于 ODBC 源。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
sqlType (SQL 数据类型)	指定字段的 SQL 数据类型。 此属性存储 ODBC 数据类型 和 仅适用于 ODBC 数据源。 仅当向应用程序提供此属性时，才会为此属性提供值。 以下是 ODBC 支持的数据类型。 有关详细信息，请参阅 ODBC 规范。 - 0 SQL_UNKNOWN_TYPE - 1 SQL_ - 2 SQL_VARCHAR - -1 SQL_LONGVARCHAR - -8 SQL_WCHAR - -9 SQL_WVARCHAR - -10 SQL_WLONGVARCHAR - 3 SQL_DECIMAL - 2 SQL_NUMERIC - 5 SQL_SMALLINT - 4 SQL_INTEGER - 7 SQL_ - 6 SQL_FLOAT - 8 SQL_DOUBLE - -7 SQL_ - -6 SQL_TINYINT - -5 SQL_BIGINT - -2 SQL_BINARY - -3 SQL_VARBINARY - -4 SQL_LONGVARBINARY - 9 个SQL_TYPE_DATE或SQL_DATE - 10 个SQL_TYPE_TIME或SQL_TIME - 11 个SQL_TYPE_TIMESTAMP或SQL_TIMESTAMP - 102 SQL_INTERVAL_MONTH - 101 SQL_INTERVAL_YEAR - 107 SQL_INTERVAL_YEAR_TO_MONTH - 103 SQL_INTERVAL_DAY - 104 SQL_INTERVAL_HOUR - 105 SQL_INTERVAL_MINUTE - 106 SQL_INTERVAL_SECOND - 108 SQL_INTERVAL_DAY_TO_HOUR - 109 SQL_INTERVAL_DAY_TO_MINUTE - 110 SQL_INTERVAL_DAY_TO_SECOND - 111 SQL_INTERVAL_HOUR_TO_MINUTE - 112 SQL_INTERVAL_HOUR_TO_SECOND - 113 SQL_INTERVAL_MINUTE_TO_SECOND - -11 SQL_GUID - -20 SQL_SIGNED_OFFSET - -22 SQL_UNSIGNED_OFFSET 此属性的可能值由 W3C XML 架构 int 数据类型定义。
uniqueList (检索到的唯一列表)	指定一个布尔值，该值指示应用程序是否能够获取字段的唯一项列表。 属性仅适用于使用 ODBC 的数据透视表，旨在与应用程序中的优化功能结合使用。 [示例：如果应用程序在从 ODBC 检索所有记录之前具有字段的唯一项列表，则填充 PivotCache 记录时可以优化内存使用率。 示例结束] 值为 1 或 true 表示应用程序能够获取字段的唯一值列表。 值为 0 或 false 表示应用程序无法获取字段的唯一值列表。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。

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

ISO/IEC29500：2008。

构造函数

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

属性

Caption	描述文字 表示架构中的以下属性：描述文字
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
DatabaseField	databaseField 表示架构中的以下属性：databaseField
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FieldGroup	FieldGroup。 表示架构中的以下元素标记：x：fieldGroup。
FirstChild	获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement)
Formula	formula 表示架构中的以下属性：公式
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement)
Hierarchy	层次 结构 表示架构中的以下属性：hierarchy
InnerText	获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement)
InnerXml	获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement)
LastChild	获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement)
Level	水平 表示架构中的以下属性： 级别
LocalName	获取当前元素的本地名称。 (继承自 OpenXmlElement)
MappingCount	mappingCount 表示架构中的以下属性：mappingCount
MCAttributes	获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement)
MemberPropertyField	memberPropertyField 表示架构中的以下属性：memberPropertyField
Name	name 表示架构中的以下属性：name
NamespaceDeclarations	获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement)
NamespaceUri	获取当前元素的命名空间 URI。 (继承自 OpenXmlElement)
NumberFormatId	numFmtId 表示架构中的以下属性：numFmtId
OpenXmlElementContext	获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement)
OuterXml	获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement)
Parent	获取当前元素的父元素。 (继承自 OpenXmlElement)
Prefix	获取当前元素的命名空间前缀。 (继承自 OpenXmlElement)
PropertyName	PropertyName 表示架构中的以下属性：propertyName
ServerField	serverField 表示架构中的以下属性：serverField
SharedItems	SharedItems。 表示架构中的以下元素标记：x：sharedItems。
SqlType	sqlType 表示架构中的以下属性：sqlType
UniqueList	uniqueList 表示架构中的以下属性：uniqueList
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()	PivotCache 字段。 此类在 Office 2007 及更高版本中可用。 当对象序列化为 xml 时，其限定名称为 x：cacheField。 (继承自 OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	返回循环访问子集合的枚举器。 (继承自 OpenXmlElement)