PivotTable 接口

定义

命名空间:

Microsoft.Office.Interop.Excel

程序集:

Microsoft.Office.Interop.Excel.dll

代表工作表上的数据透视表。 数据透视表对象是 集合的成员PivotTables。 PivotTables 集合包含某一张工作表上的所有 PivotTable 对象。

public interface class PivotTable

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

Public Interface PivotTable

属性

GuidAttribute InterfaceTypeAttribute

注解

使用 数据透视表 (index) （其中 index 是数据透视表索引号或名称）返回单个 数据透视表 对象。

因为对数据透视表进行编程可能会很复杂，所以，最方便的做法是将数据透视表操作录制到宏中，然后再修订所录制的宏代码。 若要录制宏，请在“工具”菜单上指向“宏”，然后单击“记录新宏”。

属性

_Default	仅供内部使用。
ActiveFilters	指示指定 PivotTable中的当前活动筛选器。 此为只读属性。
Allocation	获取或设置是针对编辑的每个单元格运行 UPDATE CUBE 语句，还是仅在用户基于 OLAP 数据源对数据透视表执行 What-if 分析时选择计算更改时才运行。
AllocationMethod	获取或设置在基于 OLAP 数据源对数据透视表执行 What-if 分析时分配值的方法。
AllocationValue	获取或设置基于 OLAP 数据源对数据透视表执行 What-if 分析时要分配的值。
AllocationWeightExpression	获取或设置基于 OLAP 数据源对数据透视表执行 What-if 分析时要使用的 MDX 权重表达式。
AllowMultipleFilters	设置或检索一个值，该值指示 是否可以 PivotField 同时应用多个筛选器。 读/写。
AlternativeText	获取或设置指定数据透视表的描述性 (替代) 文本字符串。
Application	返回一个 Application 对象，该对象代表 Microsoft Excel 应用程序。 此为只读属性。
CacheIndex	返回或设置数据透视表缓存的索引号。 Integer 型，可读/写。
CalculatedMembers	返回一个 CalculatedMembers 集合，该集合代表 OLAP 数据透视表的所有计算成员和计算度量值。
CalculatedMembersInFilters	获取或设置是否计算筛选器中 OLAP 服务器的计算成员。
ChangeList	获取表示 PivotTableChangeList 已基于 OLAP 数据源对指定数据透视表所做的更改列表的集合。
ColumnFields[Object]	返回一个 对象，该对象表示对象 (PivotField 单个数据透视表字段) ，或对象 (PivotFields 当前显示为列字段) 的所有字段的集合。 此为只读属性。
ColumnGrand	如此 如果 数据透视表显示列的总计。 读/写 Boolean。
ColumnRange	返回一个 Range 对象，该对象表示数据透视表中包含列区域的区域。 此为只读属性。
CompactLayoutColumnHeader	指定在紧凑行布局窗体中时，在 的PivotTable列标题中显示的描述文字。 读/写。
CompactLayoutRowHeader	指定在精简行布局窗体中时在 的PivotTable行标题中显示的描述文字。 读/写。
CompactRowIndent	返回或设置压缩行布局窗体打开时的缩进增量 PivotItems 。 读/写。
Creator	返回一个 32 位整数，该整数指示在其中创建了此对象的应用程序。 如果该对象是在 Microsoft Excel 中创建的，则此属性返回字符串 XCEL，它等同于十六进制的数字 5843454C。 只读 XlCreator。
CubeFields	返回 CubeFields 集合。 每个 CubeField 对象都包含多维数据集字段元素的属性。 此为只读属性。
DataBodyRange	返回一个 Range 对象，该对象表示包含列表中标题行和插入行之间的数据区域的区域。 此为只读属性。
DataFields[Object]	返回一个 对象，该对象表示 (对象) 的单个 PivotField 数据透视表字段，或者 (对象) PivotFields （当前显示为数据字段）的所有字段的集合。 此为只读属性。
DataLabelRange	返回一个 Range 对象，该对象表示包含数据透视表中数据字段标签的区域。 此为只读属性。
DataPivotField	返回一个 PivotField 对象，该对象代表数据透视表中的所有数据字段。 此为只读属性。
DisplayContextTooltips	控制是否为 PivotTable 单元格显示工具提示。 读/写。
DisplayEmptyColumn	如果对数值轴的 OLAP 提供程序的查询中包括非空 MDX 关键字，则返回 True。 在结果集中，OLAP 提供程序不返回空列。 如果省略非空关键字，则返回 False。 读/写 Boolean。
DisplayEmptyRow	如果对分类轴的 OLAP 提供程序的查询中包括非空 MDX 关键字，则返回 True。 在结果集中，OLAP 提供程序不返回空行。 如果省略非空关键字，则返回 False。 读/写 Boolean。
DisplayErrorString	如果数据透视表在有错误的单元格中显示用户自定义的错误字符串，则该值为 True。 默认值为 False。 读/写 Boolean。
DisplayFieldCaptions	控制是否在网格中显示行和 PivotField 列的筛选器按钮和标题。 读/写。
DisplayImmediateItems	返回或设置 Boolean，用于指明当数据透视表的数据区域为空时，行和列区域中的项是否可见。 如果该属性为 False，则当数据透视表的数据区域为空时，将隐藏行和列区域中的项。 默认值为 True。
DisplayMemberPropertyTooltips	控制是否在工具提示中显示成员属性。 读/写。
DisplayNullString	如果数据透视表在包含空值的单元格中显示用户自定义的字符串，则该值为 True。 默认值为 True。 读/写 Boolean。
EnableDataValueEditing	如果为 True，则当用户覆盖数据透视表数据区域中的值时禁用警告。 设置为 True 也可以使用户更改先前无法更改的数据值。 默认值为 False。 读/写 Boolean。
EnableDrilldown	如果启用“显示明细数据”，则该值为 True。 默认值为 True。 读/写 Boolean。
EnableFieldDialog	如果当用户双击数据透视表字段时，“数据透视表字段”对话框可用，则该属性值为 True。 默认值为 True。 读/写 Boolean。
EnableFieldList	如果为 False ，则禁用显示数据透视表字段列表的功能。 如果已经显示字段列表，则该列表将消失。 默认值为 True。 读/写 Boolean。
EnableWizard	如此 如果 数据透视表向导可用。 默认值为 True。 读/写 Boolean。
EnableWriteback	获取或设置是否为指定的数据透视表启用对数据源的写回。
ErrorString	当 属性为 True 时DisplayErrorString，返回或设置在包含错误的单元格中显示的字符串。 默认值为空字符串 ("")。 读/写 String。
FieldListSortAscending	控制字段列表中字段的 PivotTable 排序顺序。 读/写。
GrandTotalName	返回或设置显示在指定数据透视表的总计列或行标题中的文本串标志。 默认值为字符串“Grand Total”。 读/写 String。
HasAutoFormat	如果在刷新数据透视表或移动字段时自动设置格式，则该属性值为 True。 读/写 Boolean。
Hidden	检查工作表级别是否存在数据透视表。 C#) 中的布尔 (布尔值。 只读
HiddenFields[Object]	返回一个 对象，该对象表示 (对象) 的单个 PivotField 数据透视表字段，或对象 (PivotFields) 的所有字段的集合，这些字段当前不显示为行、列、页或数据字段。 此为只读属性。
InGridDropZones	此属性用于切换对象的网格内放置区域 PivotTable 。 在某些情况下，它还会影响 的 PivotTable布局。 读/写。
InnerDetail	返回或设置当最内部行或列字段的 属性为 True 时ShowDetail显示为详细信息的字段的名称。 读/写 String。
LayoutRowDefault	此属性指定首次添加到 PivotTable 时的布局设置PivotFields。 读/写。
Location	获取或设置一个 String 类型的 值，该值代表指定 PivotTable正文中的左上角单元格。 读/写。
ManualUpdate	如果数据透视表仅在用户请求时重新计算，则该值为 True。 默认值为 False。 读/写 Boolean。
MDX	返回一个 字符串 ，指示将发送到提供程序以填充当前数据透视表视图的 MDX (多维表达式) 。 此为只读属性。
MergeLabels	如果指定的数据透视表的外部行项、列项、分类汇总和总计标志使用合并单元格，则该属性值为 True。 读/写 Boolean。
Name	返回或设置对象的名称。 读/写 String。
NullString	当 属性为 True 时DisplayNullString，返回或设置在包含 null 值的单元格中显示的字符串。 默认值为空字符串 ("")。 读/写 String。
PageFieldOrder	返回或设置页字段在数据透视表布局上的顺序。 可以是以下 XlOrder 常量之一： xlDownThenOver 或 xlOverThenDown。 默认常量是 xlDownThenOver。 Integer 型，可读/写。
PageFields[Object]	返回一个 对象，该对象表示 (对象) 的单个 PivotField 数据透视表字段，或者 (当前显示为页字段 PivotFields 的对象) 的所有字段的集合。 此为只读属性。
PageFieldStyle	返回或设置用于边界页字段区域中的样式。 默认值为 null 字符串（默认时无样式）。 读/写 String。
PageFieldWrapCount	返回或设置数据透视表中每行或每列的页字段数目。 Integer 型，可读/写。
PageRange	返回一个 Range 对象，该对象代表数据透视表中包含页面区域的区域。 此为只读属性。
PageRangeCells	返回一个 Range 对象，该对象仅代表指定数据透视表中包含页面字段和项下拉列表的单元格。
Parent	返回指定对象的父对象。 只读
PivotChart	返回一个 Shape 对象，该对象代表指定隐藏的数据透视表的独立数据透视图。 此为只读属性。
PivotColumnAxis	返回表示 PivotAxis 整个列轴的 对象。 此为只读属性。
PivotFormulas	返回一个 PivotFormulas 对象，该对象代表指定 PivotTable 报表的公式集合。 此为只读属性。
PivotRowAxis	返回表示 PivotAxis 整个行轴的 对象。 此为只读属性。
PivotSelection	以标准数据透视表的选定区域格式返回或设置数据透视表的选定区域。 读/写 String。
PivotSelectionStandard	返回或设置用英语（美国）设置的标准数据透视表格式的数据透视表选定内容的 String 类型的数值。 读/写。
PreserveFormatting	如果在刷新报表或通过透视、排序或更改页字段项等操作重新计算报表时保留格式，则此属性为 True 。 读/写 Boolean。
PrintDrillIndicators	指定是否使用 PivotTable打印钻取指示器。 读/写。
PrintTitles	如果基于数据透视表设置工作表的打印标题，则该属性值为 True。 如果使用工作表的打印标题，则该属性值为 False。 默认值为 False。 读/写 Boolean。
RefreshDate	返回数据透视表或缓存最近一次刷新的日期。 只读 DateTime。
RefreshName	返回上次刷新数据透视表数据或数据透视表缓存的人员的姓名。 只读 String。
RepeatItemsOnEachPrintedPage	当打印指定的数据透视表时，如果每页第一行上都显示行、列和项标志，则该值为 True。 如果仅在第一页上打印这些标志，则该值为 False。 默认值为 True。 读/写 Boolean。
RowFields[Object]	返回一个 对象，该对象表示数据透视表中的单个字段 (PivotField 对象) 或对象 (PivotFields 当前显示为行字段) 的所有字段的集合。 此为只读属性。
RowGrand	如此 如果 数据透视表显示行的总计。 读/写 Boolean。
RowRange	返回一个 Range 对象，该对象代表数据透视表上包括行区域的区域。 此为只读属性。
SaveData	如果数据透视表的数据随工作簿一起保存，则为 True。 如果仅保存数据透视表的定义，则为 False。 读/写 Boolean。
SelectionMode	返回或设置数据透视表的结构化选择模式。 读/写 XlPTSelectionMode。
ShowCellBackgroundFromOLAP	如果 Microsoft Excel 发送到服务器的 MDX (多维表达式) 包含BackColor与联机分析处理 (OLAP) 数据集中的单元格相对应的数据区域中每个单元格的属性，则该属性值为 True。 默认值为 False。 读/写 Boolean。
ShowDrillIndicators	属性 ShowDrillIndicators 用于切换 中 PivotTable钻取指示器的显示。 读/写。
ShowPageMultipleItemLabel	如果为 True（默认），那么只要隐藏了项，并且在数据透视表视图中显示非隐藏项的总计，“( 多个项目 )”将显示在工作表的数据透视表单元格中。 读/写 Boolean。
ShowTableStyleColumnHeaders	如果列标题应显示在 中，PivotTable则 ShowTableStyleColumnHeaders属性设置为 True。 读/写。
ShowTableStyleColumnStripes	布尔属性显示带状列，其中偶数列的格式与奇数列的格式不同。 这样更易于 PivotTables阅读。 读/写。
ShowTableStyleLastColumn	仅供内部使用。
ShowTableStyleRowHeaders	如果行标题应显示在 中，PivotTable则 ShowTableStyleRowHeaders 属性设置为 True。 读/写。
ShowTableStyleRowStripes	属性 ShowTableStyleRowStripes 显示带状行，其中偶数行的格式不同于奇数行。 这样更易于 PivotTables 阅读。 读/写。
ShowValuesRow	获取或设置是否显示值行。
Slicers	Slicers获取指定数据透视表的集合。
SmallGrid	如果 Microsoft Excel 为新建的数据透视表使用一个具有两个单元格宽度和两个单元格高度的网格，则该值为 True。 如果 Excel 使用一个空白模板边框，则该值为 False。 读/写 Boolean。
SortUsingCustomLists	属性 SortUsingCustomLists 控制是否使用自定义列表对字段的项进行排序，最初在初始化 时 PivotField 和 PivotItems 按标题排序;稍后当用户应用排序时。 读/写。
SourceData	返回数据透视表的数据源。 读写 对象。
SubtotalHiddenPageItems	如果在行或列的分类汇总、块汇总和总计中包括数据透视表中的隐藏页字段项，则该值为 True。 默认值为 False。 读/写 Boolean。
Summary	获取或设置与指定数据透视表的可选文本字符串关联的说明。
TableRange1	返回一个 Range 对象，该对象表示包含整个数据透视表但不包括页字段的区域。 此为只读属性。
TableRange2	返回一个 Range 对象，该对象表示包含整个数据透视表（包括页字段）的区域。 此为只读属性。
TableStyle	返回或设置数据透视表正文中使用的样式。 默认值为 null 字符串（默认时无样式）。 读/写 String。
TableStyle2	属性 TableStyle2 指定 PivotTable 当前应用于 的 PivotTable样式。 读/写。
Tag	返回或设置与数据透视表一起保存的字符串。 读/写 String。
TotalsAnnotation	如果在基于 OLAP 数据源的指定数据透视表中，每个分类汇总和总计旁都显示有星号 (*)，则该值为 True。 默认值为 True。 读/写 Boolean。
VacatedStyle	返回或设置在刷新数据透视表时应用于已空置的单元格的样式。 默认值为 null 字符串（默认时无样式）。 读/写 String。
Value	数据透视表的名称。 读/写 String。
Version	返回 Microsoft Excel 版本号。 只读 XlPivotTableVersionList。
ViewCalculatedMembers	如果设置为 True（默认），则可以查看联机分析处理 (OLAP) 数据透视表的计算成员。 读/写 Boolean。
VisibleFields[Object]	返回一个 对象，该对象表示数据透视表中的单个字段 (PivotField 对象) 或对象 (PivotFields) 的所有可见字段的集合。 可见字段显示为行、列、页或数据字段。 此为只读属性。
VisualTotals	True (默认) 启用联机分析处理 (OLAP) 数据透视表，以便在项目隐藏在视图中后重新计算总计。 读/写 Boolean。
VisualTotalsForSets	获取或设置是否在指定数据透视表的命名集的总计中包含筛选项。

方法

_PivotSelect(String, XlPTSelectionMode)	仅供内部使用。
AddDataField(Object, Object, Object)	将数据字段添加到数据透视表中。 返回表示 PivotField 新数据字段的 对象。
AddFields(Object, Object, Object, Object)	向数据透视表或数据透视图中添加行字段、列字段和页字段。
AllocateChanges()	在基于 OLAP 数据源的数据透视表中的所有已编辑的单元格上执行回写操作。
CalculatedFields()	返回一个 CalculatedFields 集合，该集合代表指定数据透视表中的所有计算字段。 此为只读属性。
ChangeConnection(WorkbookConnection)	更改指定 PivotTable的连接。
ChangePivotCache(Object)	PivotCache更改指定 PivotTable的 。
ClearAllFilters()	方法 ClearAllFilters() 删除当前应用于 PivotTable的所有筛选器。 这包括删除对象集合PivotTable中的所有PivotFilters筛选器，删除应用的任何手动筛选，并将“报表筛选器”区域中的所有 PivotField设置为默认项。
ClearTable()	方法 ClearTable() 用于清除 PivotTable。 清除 PivotTable包括删除所有字段以及删除应用于 的所有 PivotTables筛选和排序。 此方法将 PivotTable 重置为创建后，在向它添加任何字段之前的状态。
CommitChanges()	基于 OLAP 数据源对数据透视表的数据源执行提交操作。
ConvertToFormulas(Boolean)	方法 ConvertToFormulas(Boolean) 是 1st_Excel12 中的新增方法，用于将 转换为 PivotTable 多维数据集公式。
CreateCubeFile(String, Object, Object, Object, Object)	创建数据透视表的多维数据集文件，该数据透视表与联机分析处理 (OLAP) 数据源相连接。
DiscardChanges()	放弃基于 OLAP 数据源的数据透视表中经过编辑的单元格中的所有更改。
DrillDown(PivotItem, Object)	使你能够向下钻取到基于 OLAP 或 PowerPivot 的多维数据集层次结构中的数据。
DrillTo(PivotItem, CubeField, Object)	使你能够钻取到基于 OLAP 或 PowerPivot 的多维数据集层次结构中的某个位置。
DrillUp(PivotItem, Object, Object)	使你能够向上钻取到基于 OLAP 或 PowerPivot 的多维数据集层次结构中的数据。
Dummy15(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	仅供内部使用。
Dummy2(Object, Object, Object, Object)	代表工作表上的数据透视表。 数据透视表对象是 集合的成员PivotTables。 PivotTables 集合包含某一张工作表上的所有 PivotTable 对象。
Format(XlPivotFormatType)	将数据透视表设置为预定义缩进、非缩进或交叉表格格式之一。
GetData(String)	从指定的数据透视表单元格返回数据。
GetPivotData(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	返回一个 Range 对象，该对象带有数据透视表中数据项的相关信息。
ListFormulas()	在分离工作表上创建数据透视表的计算项和计算字段的列表。
PivotCache()	返回一个 PivotCache 对象，该对象代表指定数据透视表的缓存。 此为只读属性。
PivotFields(Object)	返回一个 对象，该对象表示 (对象) 的单个 PivotField 数据透视表字段，或数据透视表中对象) (PivotFields 可见字段和隐藏字段的集合。 此为只读属性。
PivotSelect(String, XlPTSelectionMode, Object)	选定数据透视表的一部分。
PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	PivotTable创建 对象。 此方法不显示数据透视表向导。 此方法不适用于 OLE DB 数据源。 Add(PivotCache, Object, Object, Object, Object)使用 方法添加数据透视表缓存，然后基于缓存创建数据透视表。
PivotValueCell(Object, Object)	PivotValueCell检索给定数据透视表的对象，该数据透视表提供了特定的行索引和列索引。
RefreshDataSourceValues()	为处于回写模式的数据透视表中所有编辑过的单元格，从数据源检索当前值。
RefreshTable()	用源数据刷新数据透视表。 如果成功，则该值为 True。
RepeatAllLabels(XlPivotFieldRepeatLabels)	设置是否为指定数据透视表中的所有数据透视字段重复项目标签。
RowAxisLayout(XlLayoutRowType)	此方法用于同时设置所有现有 PivotField的布局选项。
ShowPages(Object)	为页字段中的每个数据项创建新的数据透视表。 每个新报表都创建在新的工作表上。
SubtotalLocation(XlSubtototalLocationType)	此方法更改所有现有 PivotFields的分类汇总位置。 更改分类汇总位置仅对大纲形式的字段产生直接的视觉效果，但是也会对表格形式的字段设置该方法。
Update()	汇报链接或数据透视表。