PivotField

PivotField class

Представляет поле в отчете сводной таблицы.

public class PivotField

Характеристики

ИмяОписание
AutoShowCount { get; set; }Представляет количество верхних или нижних элементов , которые автоматически отображаются в указанном поле сводной таблицы.
AutoShowField { get; set; }Представляет индекс поля автопоказа. -1 означает сам PivotField. Это должен быть индекс полей данных.
AutoSortField { get; set; }Представляет индекс поля автоматической сортировки. -1 означает само PivotField, остальные означают положение полей данных.
BaseFieldIndex { get; set; }Представляет базовое поле для пользовательского расчета.
BaseIndex { get; set; }Представляет индекс PivotField в базовых PivotFields.
BaseItemIndex { get; set; }Представляет элемент в базовом поле для пользовательского расчета. Допустимо только для полей данных.
BaseItemPosition { get; set; }Представляет элемент в базовом поле для пользовательского расчета. Допустимо только для полей данных. Поскольку PivotItemPosition.Custom предназначен только для чтения, если вам нужно установить PivotItemPosition.Custom, установите атрибут PivotField.BaseItemIndex.
CurrentPageItem { get; set; }Представляет текущий элемент страницы, отображаемый для поля страницы (действительно только для полей страницы).
DataDisplayFormat { get; set; }Представляет, как отображать значения, содержащиеся в поле данных.
DisplayName { get; set; }Представляет отображаемое имя PivotField.
DragToColumn { get; set; }Указывает, можно ли перетащить указанное поле в позицию столбца. Значение по умолчанию — true.
DragToData { get; set; }Указывает, можно ли перетащить указанное поле в позицию данных. Значение по умолчанию — true.
DragToHide { get; set; }Указывает, можно ли перетащить указанное поле в позицию скрытия. Значение по умолчанию — true.
DragToPage { get; set; }Указывает, можно ли перетаскивать указанное поле на позицию страницы. Значение по умолчанию — true.
DragToRow { get; set; }Указывает, можно ли перетащить указанное поле в позицию строки. Значение по умолчанию — true.
Function { get; set; }Представляет функцию, используемую для суммирования поля данных сводной таблицы.
InsertBlankRow { get; set; }Указывает, вставляется ли пустая строка после каждого элемента.
IsAscendShow { get; set; }Указывает, отображается ли указанное поле сводной таблицы автоматически по возрастанию.
IsAscendSort { get; set; }Указывает, сортируется ли указанное поле сводной таблицы автоматически по возрастанию.
IsAutoShow { get; set; }Указывает, отображается ли указанное поле сводной таблицы автоматически. Допустимо только для Excel 2003.
IsAutoSort { get; set; }Указывает, сортируется ли указанное поле сводной таблицы автоматически.
IsAutoSubtotals { get; set; }Указывает, отображаются ли в указанном поле автоматические промежуточные итоги. Значение по умолчанию — true.
IsCalculatedField { get; }Указывает, является ли указанное поле сводной таблицы вычисляемым полем.
IsIncludeNewItemsInFilter { get; set; }указывает, может ли поле включать новые элементы в ручном filter Значение по умолчанию — false.
IsInsertPageBreaksBetweenItems { get; set; }указывает, может ли поле вставлять разрывы страниц между элементами вставлять разрывы страниц после каждого элемента Значение по умолчанию — false.
IsMultipleItemSelectionAllowed { get; set; }указывает, может ли поле иметь несколько элементов , выбранных на странице field Значение по умолчанию — false.
IsRepeatItemLabels { get; set; }указывает, может ли поле повторять элементы labels Значение по умолчанию — false.
ItemCount { get; }Получает количество базовых элементов в этом сводном поле.
Items { get; }Получить все базовые предметы;
Name { get; }Представляет имя PivotField.
Number { get; set; }Представляет встроенный формат отображения чисел и дат.
NumberFormat { get; set; }Представляет пользовательский формат отображения чисел и дат.
OriginalItems { get; }Получить исходные базовые предметы;
PivotItems { get; }Получает элементы сводки поля сводки
Position { get; }Представляет индекс PivotField в PivotFields.
Range { get; }Получает диапазон группы сводного поля
ShowAllItems { get; set; }Указывает, отображаются ли все элементы в отчете сводной таблицы, , даже если они не содержат сводных данных. показывать элементы без данных Значение по умолчанию — false.
ShowCompact { get; set; }Указывает, отображать ли метки из следующего поля в том же столбце сводной таблицы view
ShowInOutlineForm { get; set; }Указывает, размещается ли это поле в виде схемы в сводной таблице view
ShowSubtotalAtTop { get; set; }, когда ShowInOutlineForm имеет значение true, промежуточные итоги отображаются вверху списка элементов, а не внизу

Методы

ИмяОписание
AddCalculatedItem(string, string)Добавить вычисляемый элемент в сводное поле.
GetCalculatedFieldFormula()Получить строку формулы указанного вычисляемого поля .
GetPivotFilterByType(PivotFilterType)Получает фильтр сводки поля сводки по типу
GetPivotFilters()Получает сводные фильтры сводного поля
GetSubtotals(PivotFieldSubtotalType)Получает, показывает ли указанное поле эти промежуточные итоги.
HideDetail(bool)Устанавливает, являются ли PivotItems в сводном поле скрытыми деталями. То есть свернуть/развернуть это поле.
HideItem(int, bool)Устанавливает, скрыт ли конкретный PivotItem в поле данных.
HideItem(string, bool)Устанавливает, скрыт ли конкретный PivotItem в поле данных.
HideItemDetail(int, bool)Устанавливает, является ли конкретный PivotItem в сводном поле скрытым.
InitPivotItems()Инициализировать сводные элементы сводного поля
IsHiddenItem(int)Указывает, скрыт ли конкретный PivotItem.
IsHiddenItemDetail(int)Указывает, скрыт ли конкретный PivotItem.
SetSubtotals(PivotFieldSubtotalType, bool)Устанавливает, будут ли в указанном поле отображаться эти промежуточные итоги.

Примеры


[C#]

Workbook book = new Workbook();
Worksheet sheet = book.Worksheets[0];
Cells cells = sheet.Cells;
cells[0, 0].Value = "fruit";
cells[1, 0].Value = "grape";
cells[2, 0].Value = "blueberry";
cells[3, 0].Value = "kiwi";
cells[4, 0].Value = "cherry";
cells[5, 0].Value = "grape";
cells[6, 0].Value = "blueberry";
cells[7, 0].Value = "kiwi";
cells[8, 0].Value = "cherry";

cells[0, 1].Value = "year";
cells[1, 1].Value = 2020;
cells[2, 1].Value = 2020;
cells[3, 1].Value = 2020;
cells[4, 1].Value = 2020;
cells[5, 1].Value = 2021;
cells[6, 1].Value = 2021;
cells[7, 1].Value = 2021;
cells[8, 1].Value = 2021;

cells[0, 2].Value = "amount";
cells[1, 2].Value = 50;
cells[2, 2].Value = 60;
cells[3, 2].Value = 70;
cells[4, 2].Value = 80;
cells[5, 2].Value = 90;
cells[6, 2].Value = 100;
cells[7, 2].Value = 110;
cells[8, 2].Value = 120;

PivotTableCollection pivots = sheet.PivotTables;

int pivotIndex = pivots.Add("=Sheet1!A1:C9", "A12", "TestPivotTable");
PivotTable pivot = pivots[pivotIndex];
pivot.AddFieldToArea(PivotFieldType.Row, "fruit");
pivot.AddFieldToArea(PivotFieldType.Column, "year");
pivot.AddFieldToArea(PivotFieldType.Data, "amount");

pivot.PivotTableStyleType = PivotTableStyleType.PivotTableStyleMedium10;

//Изменяем атрибуты PivotField
PivotField rowField = pivot.RowFields[0];
rowField.DisplayName = "custom display name";

pivot.RefreshData();
pivot.CalculateData();

//делай свое дело

book.Save("out.xlsx");

[Visual Basic]

Dim book As Workbook = New Workbook()
Dim sheet As Worksheet = book.Worksheets(0)
Dim cells As Cells = sheet.Cells

cells(0, 0).Value = "fruit"
cells(1, 0).Value = "grape"
cells(2, 0).Value = "blueberry"
cells(3, 0).Value = "kiwi"
cells(4, 0).Value = "cherry"
cells(5, 0).Value = "grape"
cells(6, 0).Value = "blueberry"
cells(7, 0).Value = "kiwi"
cells(8, 0).Value = "cherry"

cells(0, 1).Value = "year"
cells(1, 1).Value = 2020
cells(2, 1).Value = 2020
cells(3, 1).Value = 2020
cells(4, 1).Value = 2020
cells(5, 1).Value = 2021
cells(6, 1).Value = 2021
cells(7, 1).Value = 2021
cells(8, 1).Value = 2021

cells(0, 2).Value = "amount"
cells(1, 2).Value = 50
cells(2, 2).Value = 60
cells(3, 2).Value = 70
cells(4, 2).Value = 80
cells(5, 2).Value = 90
cells(6, 2).Value = 100
cells(7, 2).Value = 110
cells(8, 2).Value = 120

Dim pivots As PivotTableCollection = sheet.PivotTables
Dim pivotIndex As Int32 = pivots.Add("=Sheet1!A1:C9", "A12", "TestPivotTable")
Dim pivot As PivotTable = pivots(pivotIndex)
pivot.AddFieldToArea(PivotFieldType.Row, "fruit")
Pivot.AddFieldToArea(PivotFieldType.Column, "year")
Pivot.AddFieldToArea(PivotFieldType.Data, "amount")

pivot.PivotTableStyleType = PivotTableStyleType.PivotTableStyleMedium10

'Change PivotField's attributes
Dim rowField As PivotField = pivot.RowFields(0)
rowField.DisplayName = "custom display name"

pivot.RefreshData()
pivot.CalculateData()

book.Save("out_vb.xlsx")

Смотрите также