PivotField

PivotField class

Representa un campo en un informe de tabla dinámica.

public class PivotField

Propiedades

NombreDescripción
AutoShowCount { get; set; }Representa el número de elementos superiores o inferiores que se muestran automáticamente en el campo de tabla dinámica especificado.
AutoShowField { get; set; }Representa el índice de campo de exhibición automática. -1 significa PivotField en sí mismo. Debe ser el índice de los campos de datos.
AutoSortField { get; set; }Representa el índice de campo de clasificación automática. -1 significa PivotField en sí mismo, otros significa la posición de los campos de datos.
BaseFieldIndex { get; set; }Representa el campo base para un cálculo personalizado.
BaseIndex { get; set; }Representa el índice de PivotField en la base PivotFields.
BaseItemIndex { get; set; }Representa el elemento en el campo base para un cálculo personalizado. Válido solo para campos de datos.
BaseItemPosition { get; set; }Representa el elemento en el campo base para un cálculo personalizado. Válido solo para campos de datos. Debido a que PivotItemPosition.Custom es solo para lectura, si necesita configurar PivotItemPosition.Custom, , configure PivotField.BaseItemIndex atributo.
CurrentPageItem { get; set; }Representa el elemento de página actual que se muestra para el campo de página (válido solo para campos de página).
DataDisplayFormat { get; set; }Representa cómo mostrar los valores contenidos en un campo de datos.
DisplayName { get; set; }Representa el nombre para mostrar de PivotField.
DragToColumn { get; set; }Indica si el campo especificado se puede arrastrar a la posición de la columna. El valor predeterminado es verdadero.
DragToData { get; set; }Indica si el campo especificado se puede arrastrar a la posición de datos. El valor predeterminado es verdadero.
DragToHide { get; set; }Indica si el campo especificado se puede arrastrar a la posición oculta. El valor predeterminado es verdadero.
DragToPage { get; set; }Indica si el campo especificado se puede arrastrar a la posición de la página. El valor predeterminado es verdadero.
DragToRow { get; set; }Indica si el campo especificado se puede arrastrar a la posición de la fila. El valor predeterminado es verdadero.
Function { get; set; }Representa la función utilizada para resumir el campo de datos de la tabla dinámica.
InsertBlankRow { get; set; }Indica si se inserta una línea en blanco después de cada elemento.
IsAscendShow { get; set; }Indica si el campo de tabla dinámica especificado se muestra automáticamente de forma ascendente.
IsAscendSort { get; set; }Indica si el campo de tabla dinámica especificado se ordena automáticamente de forma ascendente.
IsAutoShow { get; set; }Indica si el campo de tabla dinámica especificado se muestra automáticamente, solo válido para excel 2003.
IsAutoSort { get; set; }Indica si el campo de tabla dinámica especificado se ordena automáticamente.
IsAutoSubtotals { get; set; }Indica si el campo especificado muestra subtotales automáticos. El valor predeterminado es verdadero.
IsCalculatedField { get; }Indica si el campo de tabla dinámica especificado es un campo calculado.
IsIncludeNewItemsInFilter { get; set; }indica si el campo puede incluir nuevos elementos en el filtro manual El valor predeterminado es falso.
IsInsertPageBreaksBetweenItems { get; set; }indica si el campo puede insertar saltos de página entre elementos insertar salto de página después de cada elemento El valor predeterminado es falso.
IsMultipleItemSelectionAllowed { get; set; }indica si el campo puede tener varios elementos seleccionados en la página field El valor predeterminado es falso.
IsRepeatItemLabels { get; set; }indica si el campo puede repetir elementos label El valor predeterminado es falso.
ItemCount { get; }Obtiene el recuento de elementos base de este campo pivote.
Items { get; }Consigue todos los elementos básicos;
Name { get; }Representa el nombre de PivotField.
Number { get; set; }Representa el formato de visualización integrado de números y fechas.
NumberFormat { get; set; }Representa el formato de visualización personalizado de números y fechas.
OriginalItems { get; }Consigue los elementos base originales;
PivotItems { get; }Obtiene los elementos pivote del campo pivote
Position { get; }Representa el índice PivotField en PivotFields.
Range { get; }Obtiene el rango de grupo del campo pivote
ShowAllItems { get; set; }Indica si se muestran todos los elementos del informe de tabla dinámica, incluso si no contienen datos de resumen. mostrar elementos sin datos El valor predeterminado es falso.
ShowCompact { get; set; }Indica si se muestran etiquetas del siguiente campo en la misma columna en la vista de tabla dinámica
ShowInOutlineForm { get; set; }Indica si el diseño de este campo en forma de esquema en la vista de tabla dinámica
ShowSubtotalAtTop { get; set; }cuando ShowInOutlineForm es verdadero, luego muestra los subtotales en la parte superior de la lista de elementos en lugar de en la parte inferior

Métodos

NombreDescripción
AddCalculatedItem(string, string)Agregue un elemento calculado al campo dinámico.
GetCalculatedFieldFormula()Obtener la cadena de fórmula del campo calculado especificado .
GetPivotFilterByType(PivotFilterType)Obtiene el filtro dinámico del campo dinámico por tipo
GetPivotFilters()Obtiene los filtros pivote del campo pivote
GetSubtotals(PivotFieldSubtotalType)Obtiene si el campo especificado muestra esos subtotales.
HideDetail(bool)Establece si los PivotItems en un campo dinámico son detalles ocultos. Es decir, contraer/expandir este campo.
HideItem(int, bool)Establece si el PivotItem específico en un campo de datos está oculto.
HideItem(string, bool)Establece si el PivotItem específico en un campo de datos está oculto.
HideItemDetail(int, bool)Establece si el PivotItem específico en un campo dinámico es un detalle oculto.
InitPivotItems()Inicie los elementos pivote del campo pivote
IsHiddenItem(int)Indica si el PivotItem específico está oculto.
IsHiddenItemDetail(int)Indica si el PivotItem específico es un detalle oculto.
SetSubtotals(PivotFieldSubtotalType, bool)Establece si el campo especificado muestra esos subtotales.

Ejemplos


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

//Cambiar los atributos de PivotField
PivotField rowField = pivot.RowFields[0];
rowField.DisplayName = "custom display name";

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

//haz tu negocio

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

Ver también

PivotConditionFormatScopeType PivotFieldCollection