PivotTable

PivotTable class

PivotTable. için özet açıklama

public class PivotTable : IDisposable

Özellikleri

İsim Tanım
AltTextDescription { get; set; } Alt text öğesinin açıklamasını alır
AltTextTitle { get; set; } altertext başlığını alır
AutoFormatType { get; set; } Özet Tablo otomatik biçim türünü alır.
BaseFields { get; } Özet Tablo raporundaki tüm alanları içeren bir PivotFields nesnesi döndürür
ColumnFields { get; } Şu anda sütun alanları olarak gösterilen bir PivotFields nesnesi döndürür.
ColumnGrand { get; set; } Özet Tablo raporunun sütunlar için genel toplamları gösterip göstermediğini gösterir.
ColumnHeaderCaption { get; set; } PivotTable’ın Sütun Başlığı Alt Yazısını Alır.
ColumnRange { get; } PivotTable raporundaki sütun alanını içeren aralığı temsil eden bir CellArea nesnesi döndürür. Salt okunur.
CustomListSort { get; set; } data sıralanırken yerleşik özel listenin dikkate alınıp alınmayacağını belirtir
DataBodyRange { get; } Üstbilgi satırı ile ekleme satırı arasındaki listede area verisini içeren aralığı temsil eden bir CellArea nesnesi döndürür. Salt okunur.
DataField { get; } Bir PivotTable’daki tüm veri alanlarını temsil eden bir PivotField nesnesi alır. Salt okunur. Yalnızca DataPiovtFiels’te iki veya daha fazla veri alanı olduğunda başlatılır. Yalnızca DataPivotField’i PivotTable satırına/sütununa eklemek için kullanılır alan . Varsayılan satır alanındadır.
DataFields { get; } Bir PivotTable’daki tüm veri alanlarını temsil eden bir PivotField nesnesi alır. Salt okunur. Yalnızca DataPiovtFiels’te iki veya daha fazla veri alanı olduğunda başlatılır. Yalnızca DataPivotField’i PivotTable satırına/sütununa eklemek için kullanılır alan . Varsayılan satır alanındadır.
DataSource { get; set; } Pivot tablonun veri kaynağını alır ve ayarlar.
DisplayErrorString { get; set; } PivotTable raporunun hata içeren hücrelerde özel bir dize gösterip göstermediğini gösterir.
DisplayImmediateItems { get; set; } PivotTable’ın veri alanı boş olduğunda satır ve sütun alanlarındaki öğelerin görünür olup olmadığını gösterir . Varsayılan değer true.
DisplayNullString { get; set; } PivotTable raporunun boş değerler içeren hücrelerde özel bir string gösterip göstermediğini gösterir.
EnableDataValueEditing { get; set; } Kullanıcının pivot tablonun veri alanındaki hücreleri düzenlemesine izin verilip verilmediğini belirten bir boole değeri belirtir. field değerlerinde hücre düzenlemeyi etkinleştir
EnableDrilldown { get; set; } Ayrıntılı incelemenin etkinleştirilip etkinleştirilmediğini alır.
EnableFieldDialog { get; set; } Kullanıcı PivotTable alanını çift tıkladığında PivotTable Alanı iletişim kutusunun kullanılabilir olup olmadığını gösterir .
EnableFieldList { get; set; } PivotTable için alan listesinin etkinleştirilip etkinleştirilmeyeceğini alır.
EnableWizard { get; set; } Özet Tablo Sihirbazı’nın kullanılabilir olup olmadığını gösterir.
ErrorString { get; set; } DisplayErrorString özelliği true olduğunda error içeren hücrelerde görüntülenen dizeyi alır.Varsayılan değer boş bir dizedir.
ExternalConnectionDataSource { get; } Harici bağlantı veri kaynağını alır.
FieldListSortAscending { get; set; } PivotTable’daki alanların alan listesinde varsayılan olmayan düzende sıralanıp sıralanmadığını gösteren bir boole değeri belirtir.
GrandTotalName { get; set; } Genel toplam sütununda veya satır başlığında görüntülenen metin dizesi etiketini döndürür. Varsayılan değer, “Genel Toplam” dizesidir.
HasBlankRows { get; set; } Boş satırların eklenip eklenmeyeceğini gösterir. Bu özellik yalnızca boş satırlar eklemesi gereken PivotTable otomatik format türleri için geçerlidir.
Indent { get; set; } Kompakt eksen için girinti artışını belirtir ve Rapor Düzenini Kompakt Form olarak ayarlamak için kullanılabilir.
IsAutoFormat { get; set; } Özet Tablo raporunun otomatik olarak biçimlendirilip biçimlendirilmediğini gösterir. Excel 2003 için özetlenebilir seçenekte bulunan “tabloyu otomatik biçimlendir” onay kutusu Pivot tabloda bulunan “güncellemede sütun genişliğini otomatik sığdır” onay kutusu Seçenekler : Excel için Düzen Biçimi 2007
IsExcel2003Compatible { get; set; } Özet Tablo yenilenirken Özet Tablo’nun Excel2003 için uyumlu olup olmadığını belirtir, doğruysa, bir dize 255 karakterden küçük veya ona eşit olmalıdır, bu nedenle dize 255 karakterden büyükse, kesilecektir. false ise, bir dize yukarıda belirtilen kısıtlamaya sahip olmayacaktır. Varsayılan değer true’dur.
IsGridDropZones { get; set; } PivotTable raporunun klasik pivot tablo düzenini gösterip göstermediğini gösterir. (ızgaradaki alanları sürüklemeyi etkinleştirir)
IsMultipleFieldFilters { get; set; } Bir PivotTable alanlarının üzerlerinde ayarlanmış birden çok filtre olup olmayacağını belirten bir boole değeri belirtir.
IsSelected { get; set; } PivotTable’ın seçili olup olmadığını gösterir.
ItemPrintTitles { get; set; } axis satırındaki özet öğe başlıklarının, tablo biçimindeki pivot alanlar için yazdırılan her sayfada tekrarlanıp tekrarlanmayacağını belirten bir bit.
ManualUpdate { get; set; } Özet Tablo raporunun yalnızca kullanıcının isteği üzerine yeniden hesaplanıp hesaplanmayacağını gösterir.
MergeLabels { get; set; } Belirtilen PivotTable raporunun dış satır öğesi, sütun öğesi, ara toplam, ve genel toplam etiketlerinin birleştirilmiş hücreleri kullanıp kullanmadığını gösterir.
MissingItemsLimit { get; set; } Bir PivotTable alanlarının üzerlerinde ayarlanmış birden çok filtre olup olmayacağını belirten bir boole değeri belirtir.
Name { get; set; } PivotTable ’nin adını alır
NullString { get; set; } DisplayNullString özelliği true olduğunda boş değerler içeren hücrelerde görüntülenen dizeyi alır .Varsayılan değer boş bir dizedir.
PageFieldOrder { get; set; } Sayfa alanlarının PivotTable raporunun düzenine eklenme sırasını alır.
PageFields { get; } Şu anda sayfa alanları olarak gösterilen bir PivotFields nesnesi döndürür.
PageFieldWrapCount { get; set; } PivotTable raporundaki her sütun veya satırdaki sayfa alanlarının sayısını alır.
PivotFilters { get; } Bir PivotFilterCollection nesnesi döndürür.
PivotFormatConditions { get; } Özet tablonun Biçim Koşullarını alır.
PivotTableStyleName { get; set; } Özetlenebilir stil adını alır ve ayarlar.
PivotTableStyleType { get; set; } Yerleşik pivot tablo stilini alır ve ayarlar.
PreserveFormatting { get; set; } Özet Tablo yenilendiğinde veya yeniden hesaplandığında biçimlendirmenin korunup korunmadığını gösterir.
PrintDrill { get; set; } Delme göstergelerinin yazdırılıp yazdırılmayacağını belirten bir boole değeri belirtir. pivot tabloda görüntülendiğinde genişletme/daraltma düğmelerini yazdırın.
PrintTitles { get; set; } Çalışma sayfası için yazdırma başlıklarının PivotTable raporunda temelli ayarlanıp ayarlanmadığını gösterir. Varsayılan değer false.
RefreshDataFlag { get; set; } Verileri Yenileyip Yenilemediğini gösterir.
RefreshDataOnOpeningFile { get; set; } Dosyayı Açarken Verileri Yenileyip Yenilemediğini gösterir.
RefreshDate { get; } PivotTable’ın en son yenilendiği tarihi alır.
RefreshedByWho { get; } Özet Tabloyu en son yenileyen kullanıcının adını alır
RowFields { get; } Şu anda satır alanları olarak gösterilen bir PivotFields nesnesi döndürür.
RowGrand { get; set; } Özet Tablo raporunun satırlar için genel toplamları gösterip göstermediğini gösterir.
RowHeaderCaption { get; set; } PivotTable’ın Satır Başlığı Resim Yazısını Alır.
RowRange { get; } PivotTable raporundaki satır alanını içeren range aralığını temsil eden bir CellArea nesnesi döndürür. Salt okunur.
SaveData { get; set; } PivotTable raporu verilerinin çalışma kitabıyla kaydedilip kaydedilmediğini gösterir.
ShowDataTips { get; set; } PivotTable veri hücreleri için araç ipuçlarının görüntülenip görüntülenmeyeceğini belirten bir boole değeri belirtir.
ShowDrill { get; set; } Genişletme/daraltma düğmelerinin gösterilip gösterilmediğini alır.
ShowEmptyCol { get; set; } Tabloya boş sütunların dahil edilip edilmeyeceğini gösteren bir boole değeri belirtir
ShowEmptyRow { get; set; } Tabloya boş satırların dahil edilip edilmeyeceğini gösteren bir boole değeri belirtir.
ShowMemberPropertyTips { get; set; } Üye özellik bilgilerinin PivotTable araç ipuçlarından çıkarılması gerekip gerekmediğini belirten bir boole değeri belirtir.
ShowPivotStyleColumnHeader { get; set; } Pivot tablodaki sütun başlığına stilin uygulanıp uygulanmayacağını belirtir.
ShowPivotStyleColumnStripes { get; set; } Sütun şerit biçimlendirmesinin uygulanıp uygulanmadığını gösterir.
ShowPivotStyleLastColumn { get; set; } Sütun şerit biçimlendirmesinin uygulanıp uygulanmadığını gösterir.
ShowPivotStyleRowHeader { get; set; } Pivot tablodaki satır başlığına stilin uygulanıp uygulanmayacağını belirtir.
ShowPivotStyleRowStripes { get; set; } Satır şerit biçimlendirmesinin uygulanıp uygulanmadığını gösterir.
ShowRowHeaderCaption { get; set; } Satır başlığı başlığının PivotTable raporunda gösterilip gösterilmediğini gösterir Alan başlıklarını ve filtre açılır menülerini görüntüleyip görüntülemediğini gösterir
ShowValuesRow { get; set; } Satır değerlerinin gösterilip gösterilmeyeceğini belirten bir boole değeri belirtir. row değerlerini gösterir
SubtotalHiddenPageItems { get; set; } Özet Tablo raporundaki gizli sayfa alanı öğelerinin satır ve sütun alt toplamlarına, blok toplamlarına ve genel toplamlara dahil edilip edilmediğini gösterir. Varsayılan değer False’dır.
TableRange1 { get; } PivotTable raporunun tamamını içeren aralığı temsil eden bir CellArea nesnesi döndürür, , ancak sayfa alanlarını içermez. Salt okunur.
TableRange2 { get; } PivotTable raporunun tamamını içeren aralığı temsil eden bir CellArea nesnesi döndürür, sayfa alanlarını içerir. Salt okunur.
Tag { get; set; } PivotTable raporuyla kaydedilmiş bir dize alır.

yöntemler

İsim Tanım
AddCalculatedField(string, string) Özet alanına hesaplanmış bir alan ekler ve onu veri alanına sürükler.
AddCalculatedField(string, string, bool) Özet alanına hesaplanmış bir alan ekler.
AddFieldToArea(PivotFieldType, int) Alanı belirli alana ekler.
AddFieldToArea(PivotFieldType, PivotField) Alanı belirli alana ekler.
AddFieldToArea(PivotFieldType, string) Alanı belirli alana ekler.
CalculateData() Özet tablonun verilerini hücrelere hesaplar.
CalculateRange() Özet tablonun aralığını hesaplar.
ChangeDataSource(string[]) Özet tablonun kaynak verilerini ayarlayın. Sayfa1!$A$1:$C$3
ClearData() PivotTable’ın verilerini ve biçimlendirmesini temizle
CopyStyle(PivotTable) Başka bir pivot tablodan adlandırılmış stili kopyalar.
Dispose() Yönetilmeyen kaynakları serbest bırakma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir.
Fields(PivotFieldType) Alan türüne göre belirli alanları alır.
Format(int, int, Style) Hücreyi döndürülebilir alanda biçimlendirin
FormatAll(Style) Döndürülebilir alandaki tüm hücreyi biçimlendirin
FormatRow(int, Style) Özetlenebilir alandaki satır verilerini biçimlendirin
GetCellByDisplayName(string) Cell nesnesini PivotField ’nin DisplayName değerine göre alır
GetChildren() Bu Özet Tablo verilerini veri kaynağı olarak kullanan Alt Özet Tabloları alır.
GetHorizontalBreaks() yatay sayfa sonlarının özet tablo satır dizin listesini al
GetSource() Özet tablonun kaynak verilerini alın.
Move(string) PivotTable’ı çalışma sayfasında farklı bir konuma taşır.
Move(int, int) PivotTable’ı çalışma sayfasında farklı bir konuma taşır.
RefreshData() Özet tablonun verilerini ve veri kaynağından gelen ayarları yeniler.
RemoveField(PivotFieldType, int) Belirli bir alandan bir alanı kaldırır area
RemoveField(PivotFieldType, PivotField) Alanı belirli alandan kaldır area
RemoveField(PivotFieldType, string) Belirli bir alandan bir alanı kaldırır area
SetAutoGroupField(int) Otomatik alan grubunu PivotTable’a göre ayarlar.
SetAutoGroupField(PivotField) Otomatik alan grubunu PivotTable’a göre ayarlar.
SetManualGroupField(int, DateTime, DateTime, ArrayList, int) PivotTable’a göre manuel alan grubunu ayarlar.
SetManualGroupField(int, double, double, ArrayList, double) PivotTable’a göre manuel alan grubunu ayarlar.
SetManualGroupField(PivotField, DateTime, DateTime, ArrayList, int) PivotTable’a göre manuel alan grubunu ayarlar.
SetManualGroupField(PivotField, double, double, ArrayList, double) PivotTable’a göre manuel alan grubunu ayarlar.
SetUngroup(int) Grubu PivotTable ile çözmeyi ayarlar
SetUngroup(PivotField) Grubu PivotTable ile çözmeyi ayarlar
ShowInCompactForm() PivotTable’ı kompakt biçimde düzenler.
ShowInOutlineForm() PivotTable’ı anahat biçiminde düzenler.
ShowInTabularForm() PivotTable’ı tablo biçiminde düzenler.
ShowReportFilterPage(PivotField) Tüm rapor filtresi sayfalarını PivotField’e göre göster, PivotField, PageFields’de bulunmalıdır.
ShowReportFilterPageByIndex(int) PageFields içindeki konum dizinine göre tüm rapor filtresi sayfalarını göster
ShowReportFilterPageByName(string) Tüm rapor filtre sayfalarını PivotField adına göre göster, PivotField, PageFields. içinde bulunmalıdır.

Örnekler


[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'in özniteliklerini değiştir
PivotField rowField = pivot.RowFields[0];
rowField.DisplayName = "custom display name";

//PivotFilter'ı ekle
int index = pivot.PivotFilters.Add(0, PivotFilterType.Count);
PivotFilter filter = pivot.PivotFilters[index];
filter.AutoFilter.FilterTop10(0, false, false, 2);

//PivotFormatCondition Ekle
int formatIndex = pivot.PivotFormatConditions.Add();
PivotFormatCondition pfc = pivot.PivotFormatConditions[formatIndex];
FormatConditionCollection fcc = pfc.FormatConditions;
fcc.AddArea(pivot.DataBodyRange);
int idx = fcc.AddCondition(FormatConditionType.CellValue);
FormatCondition fc = fcc[idx];
fc.Formula1 = "100";
fc.Operator = OperatorType.GreaterOrEqual;
fc.Style.BackgroundColor = Color.Red;

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

//işini yap

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"

'PivotFilter Ekle
Dim filterIndex As Int32 = pivot.PivotFilters.Add(0, PivotFilterType.Count)
Dim filter As PivotFilter = pivot.PivotFilters(filterIndex)
filter.AutoFilter.FilterTop10(0, False, False, 2)

'PivotFormatCondition Ekle
Dim formatIndex As Int32 = pivot.PivotFormatConditions.Add()
Dim pfc As PivotFormatCondition = pivot.PivotFormatConditions(formatIndex)
Dim fcc As FormatConditionCollection = pfc.FormatConditions
fcc.AddArea(pivot.DataBodyRange)
Dim idx As Int32 = fcc.AddCondition(FormatConditionType.CellValue)
Dim fc As FormatCondition = fcc(idx)
fc.Formula1 = "100"
fc.Operator = OperatorType.GreaterOrEqual
fc.Style.BackgroundColor = Color.Red

pivot.RefreshData()
pivot.CalculateData()

book.Save("out_vb.xlsx")

Ayrıca bakınız