PivotField

PivotField class

Représente un champ dans un rapport de tableau croisé dynamique.

public class PivotField

Propriétés

Nom La description
AutoShowCount { get; set; } Représente le nombre d’éléments supérieurs ou inférieurs qui sont automatiquement affichés dans le champ de tableau croisé dynamique spécifié.
AutoShowField { get; set; } Représente l’index de champ d’affichage automatique. -1 signifie PivotField lui-même. Ce devrait être l’index des champs de données.
AutoSortField { get; set; } Représente l’index de champ de tri automatique. -1 signifie PivotField lui-même, les autres signifient la position des champs de données.
BaseFieldIndex { get; set; } Représente le champ de base pour un calcul personnalisé.
BaseIndex { get; set; } Représente l’index PivotField dans la base PivotFields.
BaseItemIndex { get; set; } Représente l’élément dans le champ de base pour un calcul personnalisé. Valable uniquement pour les champs de données.
BaseItemPosition { get; set; } Représente l’élément dans le champ de base pour un calcul personnalisé. Valable uniquement pour les champs de données. Étant donné que PivotItemPosition.Custom est uniquement en lecture, si vous devez définir PivotItemPosition.Custom, veuillez définir l’attribut PivotField.BaseItemIndex.
CurrentPageItem { get; set; } Représente l’élément de page actuel affiché pour le champ de page (valable uniquement pour les champs de page).
DataDisplayFormat { get; set; } Représente comment afficher les valeurs contenues dans un champ de données.
DisplayName { get; set; } Représente le nom d’affichage PivotField.
DragToColumn { get; set; } Indique si le champ spécifié peut être déplacé vers la position de la colonne. La valeur par défaut est true.
DragToData { get; set; } Indique si le champ spécifié peut être déplacé vers la position des données. La valeur par défaut est true.
DragToHide { get; set; } Indique si le champ spécifié peut être déplacé vers la position masquée. La valeur par défaut est true.
DragToPage { get; set; } Indique si le champ spécifié peut être déplacé vers la position de la page. La valeur par défaut est true.
DragToRow { get; set; } Indique si le champ spécifié peut être déplacé vers la position de ligne. La valeur par défaut est true.
Function { get; set; } Représente la fonction utilisée pour résumer le champ de données du tableau croisé dynamique.
InsertBlankRow { get; set; } Indique s’il faut insérer une ligne vierge après chaque élément.
IsAscendShow { get; set; } Indique si le champ de tableau croisé dynamique spécifié s’affiche automatiquement en ordre croissant.
IsAscendSort { get; set; } Indique si le champ de tableau croisé dynamique spécifié est trié automatiquement par ordre croissant.
IsAutoShow { get; set; } Indique si le champ de tableau croisé dynamique spécifié est automatiquement affiché, uniquement valable pour Excel 2003.
IsAutoSort { get; set; } Indique si le champ de tableau croisé dynamique spécifié est trié automatiquement.
IsAutoSubtotals { get; set; } Indique si le champ spécifié affiche des sous-totaux automatiques. La valeur par défaut est true.
IsCalculatedField { get; } Indique si le champ de tableau croisé dynamique spécifié est un champ calculé.
IsIncludeNewItemsInFilter { get; set; } indique si le champ peut inclure de nouveaux éléments dans le filtre manuel La valeur par défaut est false.
IsInsertPageBreaksBetweenItems { get; set; } indique si le champ peut insérer des sauts de page entre les items insérer un saut de page après chaque item La valeur par défaut est false.
IsMultipleItemSelectionAllowed { get; set; } indique si le champ peut avoir plusieurs items sélectionnés dans la page field La valeur par défaut est false.
IsRepeatItemLabels { get; set; } indique si le champ peut répéter des éléments labels La valeur par défaut est false.
ItemCount { get; } Obtient le nombre d’éléments de base de ce champ pivot.
Items { get; } Obtenir tous les éléments de base ;
Name { get; } Représente le nom du PivotField.
Number { get; set; } Représente le format d’affichage intégré des nombres et des dates.
NumberFormat { get; set; } Représente le format d’affichage personnalisé des nombres et des dates.
OriginalItems { get; } Obtenir les éléments de base d’origine ;
PivotItems { get; } Obtient les éléments pivots du champ pivot
Position { get; } Représente l’index PivotField dans PivotFields.
Range { get; } Obtient la plage de groupe du champ pivot
ShowAllItems { get; set; } Indique si tous les éléments du rapport de tableau croisé dynamique sont affichés, même s’ils ne contiennent pas de données récapitulatives. affiche les éléments sans données La valeur par défaut est false.
ShowCompact { get; set; } Indique si les étiquettes d’affichage du champ suivant dans la même colonne sur la vue Tableau croisé dynamique
ShowInOutlineForm { get; set; } Indique si la disposition de ce champ sous forme de plan sur la vue Tableau croisé dynamique
ShowSubtotalAtTop { get; set; } lorsque ShowInOutlineForm est vrai, alors affiche les sous-totaux en haut de la liste des éléments au lieu d’en bas

Méthodes

Nom La description
AddCalculatedItem(string, string) Ajouter un élément calculé au champ pivot.
GetCalculatedFieldFormula() Obtenir la chaîne de formule du champ calculé spécifié .
GetPivotFilterByType(PivotFilterType) Obtient le filtre pivot du champ pivot par type
GetPivotFilters() Obtient les filtres de pivot du champ pivot
GetSubtotals(PivotFieldSubtotalType) Obtient si le champ spécifié affiche ces sous-totaux.
HideDetail(bool) Définit si les PivotItems d’un champ pivot sont des détails masqués. C’est-à-dire réduire/développer ce champ.
HideItem(int, bool) Définit si le PivotItem spécifique dans un champ de données est masqué.
HideItem(string, bool) Définit si le PivotItem spécifique dans un champ de données est masqué.
HideItemDetail(int, bool) Définit si le PivotItem spécifique dans un champ pivot est un détail caché.
InitPivotItems() Init les éléments pivot du champ pivot
IsHiddenItem(int) Indique si le PivotItem spécifique est masqué.
IsHiddenItemDetail(int) Indique si le PivotItem spécifique est un détail caché.
SetSubtotals(PivotFieldSubtotalType, bool) Définit si le champ spécifié affiche les sous-totaux.

Exemples


[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;

//Modifier les attributs de PivotField
PivotField rowField = pivot.RowFields[0];
rowField.DisplayName = "custom display name";

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

//faites vos affaires

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")

Voir également