DataField 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
数据字段项。
此类在 Office 2007 及更高版本中提供。
当对象序列化为 xml 时，其限定名称为 x：dataField。
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataFieldExtensionList))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "dataField")]
public class DataField : DocumentFormat.OpenXml.OpenXmlCompositeElementpublic class DataField : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr(22, "dataField")]
public class DataField : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:dataField")]
public class DataField : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.SchemaAttr("x:dataField")]
public class DataField : DocumentFormat.OpenXml.TypedOpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataFieldExtensionList))]
public class DataField : DocumentFormat.OpenXml.OpenXmlCompositeElement[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataFieldExtensionList))]
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class DataField : DocumentFormat.OpenXml.OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataFieldExtensionList))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "dataField")>]
type DataField = class
inherit OpenXmlCompositeElementtype DataField = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr(22, "dataField")>]
type DataField = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:dataField")>]
type DataField = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.SchemaAttr("x:dataField")>]
type DataField = class
inherit TypedOpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataFieldExtensionList))>]
type DataField = class
inherit OpenXmlCompositeElement[<DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DataFieldExtensionList))>]
[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type DataField = class
inherit OpenXmlCompositeElementPublic Class DataField
Inherits OpenXmlCompositeElementPublic Class DataField
Inherits TypedOpenXmlCompositeElement- 继承
- 继承
- 属性
注解
[ISO/IEC 29500-1 第 1 版]
dataField (Data Field Item)
表示源列表、表或数据库中的字段，该字段包含数据透视表中汇总的数据。
31cf3e83-d786-44cc-a73d-8fda196a364c
数据字段表示从源列表或数据库中的字段派生的数据。 [示例：例如，“运动”字段可能来自源列表中的一列，该列标记为“运动”，并包含源列表包含其销售数字的各种运动 (高尔夫、网球) 的名称。 示例结束]
源数据可以从 SpreadsheetML 列表或区域、外部数据库或多维数据集或其他数据透视表获取。 数据字段使用摘要函数合并基础源数据中的值。 还可以使用自定义计算来比较数据值，或者添加自己的公式来使用报表或其他工作表数据的元素。
[示例：
<dataFields count="1">
<dataField name="Sum of Sales Amount" fld="25" baseField="0" baseItem="0"/>
</dataFields>
示例结束]
| 父元素 |
|---|
| dataFields (§18.10.1.23) |
| 子元素 | 第 |
|---|---|
| extLst (Future Feature Data Storage Area) | §18.2.10 |
| 属性 | 说明 |
|---|---|
| baseField ('将数据显示为'基字段) | 指定使用 ShowDataAs 计算时基字段的索引。 此属性的可能值由 W3C XML 架构 int 数据类型定义。 |
| baseItem (“将数据显示为”基本设置) | 指定使用 ShowDataAs 计算时基项的索引。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。 |
| fld (Field) | 指定此数据项汇总的 pivotCacheRecords 部件中 (r>) 字段<的索引。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。 |
| 名称 (数据字段名称) | 指定数据字段的名称。 此属性的可能值由 ST_Xstring 简单类型 (§22.9.2.19) 定义。 |
| numFmtId (数字格式 ID) | 指定应用于此数据字段的数字格式的索引。 数字格式写入样式部分。 有关数字格式的详细信息，请参阅样式部分 (§18.8) 。 单元格表和数据透视表提供的格式设置信息不需要达成一致。 如果这两种格式不同，则单元格级格式优先。 如果更改数据透视表的布局，则数据透视表格式将优先。 此属性的可能值由 ST_NumFmtId 简单类型 (§18.18.47) 定义。 |
| showDataAs (将数据显示为显示格式) | 指定此数据字段的显示格式。 单元格表和数据透视表提供的格式设置信息不需要达成一致。 如果这两种格式不同，则单元格级格式优先。 如果更改数据透视表的布局，则数据透视表格式将优先。 此属性的可能值由 ST_ShowDataAs 简单类型 (§18.18.70) 定义。 |
| 小计 (小计) | 指定应用于此数据字段的聚合函数。 此属性的可能值由 ST_DataConsolidateFunction 简单类型 (§18.18.17) 定义。 |
[注意：此元素的内容模型 (CT_DataField) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]
ISO/IEC29500：2008。
构造函数
| DataField() |
初始化 DataField 类的新实例。 |
| DataField(IEnumerable<OpenXmlElement>) |
使用指定的子元素初始化 DataField 类的新实例。 |
| DataField(OpenXmlElement[]) |
使用指定的子元素初始化 DataField 类的新实例。 |
| DataField(String) |
从外部 XML 初始化 DataField 类的新实例。 |
属性
| BaseField |
baseField 表示架构中的以下属性：baseField |
| BaseItem |
baseItem 表示架构中的以下属性：baseItem |
| ChildElements |
获取当前元素的所有子节点。 (继承自 OpenXmlElement) |
| DataFieldExtensionList |
DataFieldExtensionList。 表示架构中的以下元素标记：x：extLst。 |
| ExtendedAttributes |
获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement) |
| Features |
IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement) |
| Field |
fld 表示架构中的以下属性： fld |
| FirstChild |
获取当前 OpenXmlElement 元素的第一个子元素。 (继承自 OpenXmlCompositeElement) |
| HasAttributes |
获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement) |
| HasChildren |
获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlCompositeElement) |
| InnerText |
获取或设置当前节点及其所有子节点的串联值。 (继承自 OpenXmlCompositeElement) |
| InnerXml |
获取或设置仅表示当前节点的子节点的标记。 (继承自 OpenXmlCompositeElement) |
| LastChild |
获取当前 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlCompositeElement) |
| LocalName |
数据字段项。 此类在 Office 2007 及更高版本中提供。 当对象序列化为 xml 时，其限定名称为 x：dataField。 |
| LocalName |
获取当前元素的本地名称。 (继承自 OpenXmlElement) |
| MCAttributes |
获取或设置标记兼容性属性。 如果未为当前元素定义标记兼容性属性，则返回 null。 (继承自 OpenXmlElement) |
| Name |
name 表示架构中的以下属性：name |
| NamespaceDeclarations |
获取在当前元素中定义的所有命名空间声明。 如果没有命名空间声明，则返回空枚举器。 (继承自 OpenXmlElement) |
| NamespaceUri |
获取当前元素的命名空间 URI。 (继承自 OpenXmlElement) |
| NumberFormatId |
numFmtId 表示架构中的以下属性：numFmtId |
| OpenXmlElementContext |
获取当前元素的 OpenXmlElementContext。 (继承自 OpenXmlElement) |
| OuterXml |
获取表示当前元素及其所有子元素的标记。 (继承自 OpenXmlElement) |
| Parent |
获取当前元素的父元素。 (继承自 OpenXmlElement) |
| Prefix |
获取当前元素的命名空间前缀。 (继承自 OpenXmlElement) |
| ShowDataAs |
showDataAs 表示架构中的以下属性：showDataAs |
| Subtotal |
小计 表示架构中的以下属性：小计 |
| 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：dataField。 (继承自 OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
返回循环访问子集合的枚举器。 (继承自 OpenXmlElement) |