PivotField 接口

定义

命名空间:

Microsoft.Office.Interop.Excel

程序集:

Microsoft.Office.Interop.Excel.dll

代表数据透视表中的一个字段。 PivotField 对象是 集合的成员PivotFields。 PivotFields 集合包含数据透视表中的所有字段，包括隐藏字段。

public interface class PivotField

[System.Runtime.InteropServices.Guid("00020874-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface PivotField

Public Interface PivotField

属性

GuidAttribute InterfaceTypeAttribute

注解

使用 PivotFields (index) （其中 index 是字段名称或索引号）返回单个 PivotField 对象。

在某些情况下，使用返回数据透视表字段子集的属性之一可能更容易。 以下属性可用：

• CubeFields 财产
• DataFields[Object] 财产
• HiddenFields[Object] 财产
• PageFields[Object] 财产
• RowFields[Object] 财产
• VisibleFields[Object] 财产

属性

_Default	仅供内部使用。
AllItemsVisible	检索一个值，该值指示是否对 Microsoft.Office.Interop.Excel.Pivotfield应用了任何手动筛选。 此为只读属性。
Application	返回一个 _Application 对象，该对象代表 Microsoft Excel 应用程序。 此为只读属性。
AutoShowCount	返回指定数据透视表字段中自动显示的首项号或末项号。 只读 Integer。
AutoShowField	返回数据字段的名称，该字段用于判断在指定数据透视表字段中自动显示的是首项还是末项。 只读 String。
AutoShowRange	如果指定数据透视表字段中自动显示首项，则返回 xlTop；如果自动显示末项，则返回 xlBottom。 只读 Integer。
AutoShowType	如果AutoShow(Int32, Int32, Int32, String)为指定的数据透视表字段启用 ，则返回 xlAutomatic;如果禁用 AutoShow，则返回 xlManual。 只读 Integer。
AutoSortCustomSubtotal	返回对应于用于自动对指定 PivotTable 字段进行排序的自定义小计的整数。 此为只读属性。
AutoSortField	返回用于对指定数据透视表字段进行自动排序的数据字段的名称。 只读 String。
AutoSortOrder	返回用于对指定数据透视表字段进行自动排序的次序。 可以是常量之 XlSortOrder 一。 只读 Integer。
AutoSortPivotLine	返回 PivotLine 用于自动对指定 PivotTable 字段进行排序的 。 此为只读属性。
BaseField	返回或设置自定义计算的基准字段。 本属性仅对数据字段有效。 读取/写入 对象 。
BaseItem	返回或设置自定义计算的基字段中的项。 仅对数据字段有效。 读取/写入 对象 。
Calculation	返回或设置由指定字段执行的计算类型。 此属性仅对数据字段有效。 读/写 XlPivotFieldCalculation。
Caption	透视字段的标签文本。 只读 String。
ChildField	返回一个 PivotField 对象，该对象表示指定字段 (的子字段（如果该字段已分组，并且) 子字段）。 此为只读属性。
ChildItems[Object]	返回一个 对象，该对象表示 (对象) PivotItem 的单个数据透视表项，或 (对象) PivotItems 的所有项的集合，该对象是指定字段中的组子级或指定项的子级。 此为只读属性。
Creator	返回一个 32 位整数，该整数指示在其中创建了此对象的应用程序。 如果该对象是在 Microsoft Excel 中创建的，则此属性返回字符串 XCEL，它等同于十六进制的数字 5843454C。 只读 XlCreator。
CubeField	返回 CubeField 指定数据透视表字段的降序对象。 此为只读属性。
CurrentPage	返回或设置页字段的当前页显示（仅对页字段有效）。 读取/写入 对象 。
CurrentPageList	返回或设置对应于项目列表的字符串数组，该项目列表包含于数据透视表的多项目页字段中。 读取/写入 对象 。
CurrentPageName	返回或设置指定数据透视表上的当前显示页。 该页名称将出现在页字段中。 注意，只有当已存在当前显示页时，本属性才有效。 读/写 String。
DatabaseSort	如果为 True，则允许手动更改数据透视表字段中项目的位置。 如果字段没有手动定位的项，则返回 True 。 读/写 Boolean。
DataRange	返回 对象 Range 。 此为只读属性。
DataType	返回一个常量，用于描述数据透视表字段中的数据类型。 只读 XlPivotFieldDataType。
DisplayAsCaption	此属性用于将 的成员 PivotField属性显示为标题。 此为只读属性。
DisplayAsTooltip	此属性用于指定是否在工具提示中显示特定成员属性 PivotField 。 读/写。
DisplayInReport	此属性用于指定是否在 中PivotTable显示指定的成员属性PivotField。 读/写。
DragToColumn	如果指定字段能被拖动到列位置上，则为 True。 默认值为 True。 读/写 Boolean。
DragToData	如果指定字段可被拖动到数据位置上，则为 True。 默认值为 True。 读/写 Boolean。
DragToHide	如果通过将字段拖离数据透视表可隐藏该字段，则为 True。 默认值为 True。 读/写 Boolean。
DragToPage	如果字段可被拖动到页位置上，则为 True。 默认值为 True。 读/写 Boolean。
DragToRow	如果字段可被拖动到行位置上，则为 True。 默认值为 True。 读/写 Boolean。
DrilledDown	如果指定数据透视表字段或数据透视表项的标志设置为“drilled”（展开或可见），则为 True。 读/写 Boolean。
EnableItemSelection	如果为 False，则在用户界面中禁止使用下拉字段的功能。 默认值为 True。 读/写 Boolean。
EnableMultiplePageItems	用于指定对于页面区域中的字段是否在筛选器下拉列表中显示复选框。 读/写。
Formula	以 A1 样式表示法读/写 String 返回或设置对象的公式。
Function	返回或设置对数据透视表字段汇总时所使用的函数（仅用于数据字段）。 读/写 XlConsolidationFunction。
GroupLevel	返回一组字段中指定字段的位置（如果该字段是分组字段集合中的成员）。 此为只读属性。
Hidden	此属性用于隐藏 OLAP 层次结构的各个级别。 读/写。
HiddenItems[Object]	返回一个 对象，该对象表示 (对象) 的单个 PivotItem 隐藏数据透视表项，或指定字段中对象) (PivotItems 所有隐藏项的集合。 此为只读属性。
HiddenItemsList	返回或设置一个 Object 类型的值 ，该值指定数据透视表字段隐藏项的字符串数组。 读/写。
IncludeNewItemsInFilter	允许开发人员指定在对 应用 PivotField手动筛选时是否应跟踪排除项或包含项。 读/写。
IsCalculated	如此 如果 数据透视表字段或数据透视表项是计算字段或项。 只读 Boolean。
IsMemberProperty	如果数据透视表字段包含成员属性，则返回 True。 只读 Boolean。
LabelRange	PivotField对于 对象，返回一个 Range 对象，该对象表示包含字段标签的单元格 (或单元格) 。 PivotItem对于 对象，返回一个 Range 对象，该对象代表数据透视表中包含该项的所有单元格。 此为只读属性。
LayoutBlankLine	如果在数据透视表的指定行字段后插入了一个空行，则该值为 True。 默认值为 False。 读/写 Boolean。
LayoutCompactRow	指定 PivotField 是否压缩 ， (多个 的 PivotField项在选择行时显示在单个列中) 。 读/写。
LayoutForm	返回或设置指定数据透视表项的显示方式 - 表格格式或大纲格式。 读/写 XlLayoutFormType。
LayoutPageBreak	如果每个字段后都插入了分页符，则该值为 True。 默认值为 False。 读/写 Boolean。
LayoutSubtotalLocation	返回或设置与指定字段相关（在其上面或下面）的数据透视表字段分类汇总的位置。 读/写 XlSubtototalLocationType。
MemberPropertyCaption	MemberPropertyCaption设置属性控制将哪个成员属性用作给定级别的描述文字。 读/写。
MemoryUsed	返回对象当前使用的内存量（以字节为单位）。 只读 Integer。
Name	返回或设置对象的名称。 读/写 String。
NumberFormat	返回或设置对象的格式代码。 读/写 String。
Orientation	指定数据透视表中字段的位置。 读/写 XlPivotFieldOrientation。
Parent	返回指定对象的父对象。 只读。
ParentField	返回一个 PivotField 对象，该对象表示数据透视表字段，该字段是指定对象的组父级。 该字段必须已分组，并且必须具有父字段。 此为只读属性。
ParentItems[Object]	返回一个 对象，该对象表示 (对象) 的单个 PivotItem 数据透视表项，或 (对象) PivotItems （指定字段中的组父级）的所有项的集合。 指定字段必须是另一个字段的组父级。 此为只读属性。
PivotFilters	返回或设置 PivotFilters 指定 PivotField 对象的 。 此为只读属性。
Position	字段 (第一、第二、第三等位置) (行、列、页、数据) 方向的所有字段。 读取/写入 对象 。
PropertyOrder	只对属于成员属性字段的数据透视表字段有效。 返回一个 Integer 类型的值，指示成员属性在其所属的多维数据集字段中的显示位置。 读/写。
PropertyParentField	返回一个 PivotField 对象，该对象表示此字段中的属性所属的字段。
RepeatLabels	获取或设置是否在指定数据透视字段的数据透视表中重复项标签。
ServerBased	如果指定数据透视表的数据源为外部数据源，并且只检索与选定页字段相匹配的数据项，则该属性值为 True。 读/写 Boolean。
ShowAllItems	如果显示数据透视表中的所有项目（即使这些项目中不包含汇总数据），则该值为 True。 默认值为 False。 读/写 Boolean。
ShowDetail	获取或设置指定的 PivotField 是否显示详细信息。 读/写。
ShowingInAxis	指示 当前是否 PivotField 在 中 PivotTable 可见。 此为只读属性。
SourceCaption	属性SourceCaption仅适用于 OLAPPivotTable，并返回 OLAP 服务器的原始PivotField描述文字。 此为只读属性。
SourceName	返回指定对象的名称，因为它出现在指定数据透视表的原始源数据中。 如果用户在创建数据透视表后重命名了项，则这可能不同于当前项名称。 只读 String。
StandardFormula	返回或设置一个 String 值，该值指定使用标准英语（美国）格式的公式。 读/写。
SubtotalName	返回或设置显示在指定数据透视表的分类汇总列或行标题中的文本字符串标志。 默认值为“Subtotal”。 读/写 String。
Subtotals[Object]	返回或设置与指定字段同时显示的分类汇总。 仅对非数据字段有效。 读取/写入 对象 。
TotalLevels	返回当前字段组中的字段总数。 如果字段没有分组或数据源基于的是 OLAP，则 TotalLevels 将返回值 1。 只读 Integer。
UseMemberPropertyAsCaption	此属性用于控制是否将成员属性标题用于 PivotItem 的 PivotField标题。 读/写。
Value	数据透视表中指定字段的名称。 读/写 String。
VisibleItems[Object]	返回一个 对象，该对象表示对象) (单个 PivotItem 可见数据透视表项，或指定字段中对象) PivotItems (所有可见项的集合。 此为只读属性。
VisibleItemsList	返回或设置一个 Object 类型的值 ，该对象指定一个字符串数组，这些字符串表示应用于 的 PivotField手动筛选器中包含的项。 读/写。

方法

AddPageItem(String, Object)	向具有多个项的页面字段添加其他项。
AutoShow(Int32, Int32, Int32, String)	显示指定数据透视表中行字段、页字段或列字段顶部或底部数据项的个数。
AutoSort(Int32, String)	为数据透视表建立自动字段排序规则。
AutoSortEx(Int32, String, Object, Object)	代表数据透视表中的一个字段。 PivotField 对象是 集合的成员PivotFields。 PivotFields 集合包含数据透视表中的所有字段，包括隐藏字段。
CalculatedItems()	返回一个 CalculatedItems 集合，该集合代表指定数据透视表中的所有计算项。 此为只读属性。
ClearAllFilters()	调用此方法会删除当前应用于 PivotField的所有筛选器。 这包括从 PivotFilters 的集合 PivotField 中删除所有筛选器，以及删除应用于 PivotField 的任何手动筛选。 PivotField如果 位于“报表筛选器”区域中，则所选项将设置为默认项。
ClearLabelFilters()	此方法删除 集合PivotField中的所有PivotFilters标签筛选器或所有日期筛选器。
ClearManualFilter()	提供了一种简单的方法，用于将 中 PivotTables的所有项的 PivotFieldVisible 属性设置为 True，并清空 OLAP PivotTables中的 HiddenItemsList 和 VisibleItemsList 集合。
ClearValueFilters()	调用此方法会删除 集合PivotField中的所有PivotFilters值筛选器。
Delete()	删除对象。
DrillTo(String)	DrillTo 方法支持从另一PivotField个 钻取到指定的 PivotField 。
PivotItems(Object)	返回一个 对象，该对象表示对象 () 的单个 PivotItem 数据透视表项，或指定字段中对象) PivotItems (所有可见项和隐藏项的集合。 此为只读属性。