Documentation – Pivot Tablo Ekle

Net: Pivot Tablosunu Biçimlendirme

Mon, 01 Jan 0001 00:00:00 +0000

Döndürme Tablosu Görünümü

Bir Pivot Tablosu Nasıl Oluşturulur, basit bir pivot tablosu nasıl oluşturulurun açıklanmasının yanı sıra bu makale, çeşitli özellikleri ayarlayarak bir pivot tablosunun görünümünü özelleştirmeyi açıklar:

Pivot tablo format seçenekleri
Pivot alanları format seçenekleri
Veri alanı format seçenekleri

Döndürme Tablosu Biçim Seçeneklerini Ayarlama

Toplam Otomatik Biçim Türünü Ayarlama

Microsoft Excel, birkaç farklı önceden ayarlanmış rapor formatı sunar. Aspose.Cells, bu formatlama seçeneklerini de destekler. Bunlara erişmek için:

1. {0} değeri true olarak ayarlayın.

PivotTable.IsAutoFormat değerini true olarak ayarlayın.
PivotTableAutoFormatType numaralandırmasından bir biçimlendirme seçeneği atayın.

Biçim Seçeneklerini Ayarlama

Aşağıdaki kod örneği, pivot tablosunu satır ve sütunlar için toplamları göstermek üzere biçimlendirme ve raporun alan sırasını ayarlamayı gösterir. Ayrıca, null değerler için özel bir dize ayarlamak da gösterilir.

Görünümü Manuel Olarak Ayarlama

Pivot Tablo Raporunun nasıl göründüğü ile ilgili nasıl biçimlendirileceğiniz, önceden ayarlanmış rapor formatlarını değil, {0} ve {1} yöntemlerini kullanarak el ile ayarlamak için kullanılır. İstenen biçimlendirme için bir stil nesnesi oluşturun, örneğin:

Pivot Alanı Biçim Seçeneklerini Ayarlama

Satır alanlarına erişim.
Alt toplamları ayarlama.
Otomatik sıralamayı ayarlama.
Otomatik gösterimi ayarlama.

Satır/Sütun/Sayfa Alanları Biçimi Ayarlama

Veri alanları biçimini ayarlama

Aşağıdaki kod örneği, veri alanları için görüntü biçimlerini ve sayı biçimini ayarlamayı göstermektedir.

Pivot Alanlarını Temizleme

PivotFieldCollection, örneğin sayfa, sütun, satır veya veri gibi tüm pivot alanlarını temizlemenize izin veren Clear() adında bir yönteme sahiptir. Örneğin, tüm veri alanlarını temizlemek istediğinizde, bunu kullanın. Aşağıdaki kod örneği, bir veri alanındaki tüm pivot alanlarını temizlemeyi göstermektedir.

Net: Özet Tabloları ve Özet Grafikler Oluşturma

Mon, 01 Jan 0001 00:00:00 +0000

Bir özet tablo, kayıtların etkileşimli bir özeti. Örneğin, bir çalışma sayfasındaki bir listede yüzlerce fatura girişiniz olabilir. Bir özet tablo, faturaları müşteri, ürün veya tarihe göre toplayabilir. Microsoft Excel ile özet tablonun düğmeleri sürüklenerek bilgileri hızlı bir şekilde yeniden düzenlemek mümkündür.

Bir özet grafik, bir özet tablonun verilerinin etkileşimli grafiksel bir temsilidir. Özet grafikler Excel 2000’de tanıtılmıştır. Özet grafik kullanmak, özet tablonun alt toplamlarını ve toplamlarını otomatik olarak oluşturduğu için verileri anlamak daha da kolaylaştırır.

Aspose.Cells, pivot tablolarını ve pivot grafiklerini destekler.

Özet Tabloları ve Grafikler Eklemek

Aspose.Cells, özet tabloları oluşturmak için kullanılan özel bir sınıf kümesi sağlar. Bu sınıflar, PivotTable nesnelerini oluşturmak ve ayarlamak için kullanılır ve temel PivotTable nesnesinin yapı taşları olarak hareket ederler:

PivotField, bir özet tablo raporundaki bir alan.
PivotFields, bir özet tablodaki tüm PivotField nesnelerinin koleksiyonu.
PivotTable, bir çalışma sayfasındaki bir PivotTable raporu.
PivotTables, çalışma sayfasındaki tüm PivotTable nesnelerinin koleksiyonu.

Aspose.Cells’i kullanmaya hazırlık

Aspose.Cells’i indirin ve kurun:
1. Aspose.Cells’i İndirin.
2. Geliştirme bilgisayarınıza kurun. Tüm Aspose bileşenleri, kurulduğunda değerlendirme modunda çalışır. Değerlendirme modunun bir süre sınırı yoktur ve üretilen belgelere sadece filigranlar ekler. Bileşenle tam kapasitede çalışmak için geçerli bir lisansa sahip olmanız gerekir.
Bir proje oluşturun:
1. Visual Studio.Net’i başlatın.
2. Yeni bir konsol uygulaması oluşturun.
Referanslar ekleyin: Projenize Aspose.Cells bileşenine referans ekleyin, örneğin…\Program Files\Aspose\Aspose.Cells\Bin\Net1.0\Aspose.Cells.dll

Pivot Tablo Ekleme

Aspose.Cells kullanarak bir pivot tablosu oluşturmak için:

Bir Hücre nesnesi’nin PutValue/setValue yöntemini kullanarak bir çalışma sayfasındaki hücrelere bazı veriler ekleyin. Ayrıca zaten verilerle doldurulmuş bir şablon dosyası kullanabilirsiniz. Veriler, pivot tablosunun veri kaynağı olarak kullanılacaktır.
PivotTables koleksiyonunun add yöntemini (Worksheet nesnesinde kapsüllenmiş) çağırarak çalışma sayfasına bir pivot tablosu ekleyin.
Yeni PivotTable nesnesine PivotTables koleksiyonundan endeksini geçerek erişin. # PivotTable nesnesinde kapsanan herhangi bir pivot tablo nesnesini kullanarak tabloyu yönetin.

Kod örnekleri aşağıda verilmiştir.

Pivot Grafik Ekleme

Aspose.Cells kullanarak bir PivotChart oluşturmak için:

Bir grafik ekleyin.
Grafik PivotSource’unu elektronik tabloda zaten mevcut bir pivot çizelgesine atıf yapacak şekilde ayarlayın.
Diğer özellikleri ayarlayın.

Net: Pivot Tablosu ve Kaynak Veri

Mon, 01 Jan 0001 00:00:00 +0000

Pivot Tablosunun Kaynak Verisi

Farklı veri kaynaklarından (örneğin bir veritabanı) alınan verileri alan ve tasarım zamanında bilinmeyen pivota tabloları olan Microsoft Excel raporları oluşturmak istediğinizde bazı durumlar olabilir. Bu makale, bir pivot tablosunun veri kaynağını dinamik olarak değiştirmenin bir yaklaşımını sunar.

Bir Pivot Tablosunun Veri Kaynağını Değiştirme

Yeni bir tasarımcı şablonu oluşturma.
1. Aşağıdaki ekran görüntüsünde olduğu gibi yeni bir tasarımcı şablonu dosyası oluşturun.
2. Ardından bu hücre aralığına atıfta bulunan DataSource adlı bir adlandırılmış aralık tanımlayın.
  
  Bir tasarımcı şablon oluşturma ve DataSource adlı adlandırılmış aralık tanımlama

Bu adlandırılmış aralığa dayalı bir Özet Tablo Oluşturma.
1. Microsoft Excel’de Veri‘yi seçin, ardından Özet Tablo ve Özet Tablo Grafik Raporu’nu seçin.
2. İlk adımda oluşturulan adlandırılmış aralığa dayalı bir özet tablo oluşturun.
  
  DataSource adlı adlandırılmış aralığa dayalı bir özet tablo oluşturma

İlgili alanı özet tablo satır ve sütununa sürükleyin, ardından aşağıdaki ekran görüntüsünde olduğu gibi sonuç özet tablosunu oluşturun.

İlgili alana dayalı bir özet tablo oluşturmak

Özet tabloyu sağ tıklayın ve Tablo Seçenekleri‘ni seçin.
1. Veri seçenekleri ayarlarında Açılışta yenile‘yi işaretleyin.
  
  Özet tablo seçeneklerini ayarlama

Şimdi bu dosyayı tasarımcı şablon dosyanız olarak kaydedebilirsiniz.

Yeni veri eklenmesi ve özet tablonun kaynak verisinin değiştirilmesi.
1. Tasarımcı şablon oluşturulduktan sonra, özet tablonun kaynak verisini değiştirmek için aşağıdaki kodu kullanın.

Aşağıdaki örnek kodu çalıştırarak pivot tablosunun kaynak verisini değiştirin.

Net: Pivot Tablosunda Hesaplanmış Alan Ekleme

Mon, 01 Jan 0001 00:00:00 +0000

Olası Kullanım Senaryoları

Bilgisine sahip olduğunuz verilere dayalı olarak bir pivot tablosu oluşturduğunuzda, içindeki verilerin istediğiniz gibi olmadığını fark edersiniz. İstediğiniz veri, bu orijinal verilerin bir kombinasyonudur. Örneğin, veriden önce verilerin çıkarılması, çarpılması ve bölünmesi gerekebilir. Bu durumda, bir hesaplanmış alan oluşturmanız ve hesaplama için ilgili formülü ayarlamanız gerekir. Daha sonra hesaplanmış alanda bazı istatistikler ve diğer işlemleri gerçekleştirin.

Excel’de Pivot Tablosunda Hesaplanmış Alan Ekleme

Excel’de bir PivotTable’a hesaplanmış bir alan eklemek için şu adımları izleyin:

Bir hesaplanmış alan eklemek istediğiniz PivotTable’ı seçin.
Kuruluş sekmesine gidin ve üzerinde PivotTable Analizi olan sekmeyi seçin.
“Alanlar, Öğeler ve Kümeler” üzerine tıklayın ve ardından açılır menüden “Hesaplanmış Alan"ı seçin.
“Ad” alanına hesaplanmış alan için bir ad girin.
“Formül” alanına, kullanmak istediğiniz PivotTable alan adları ve matematiksel operatörleri kullanarak gerçekleştirmek istediğiniz hesaplama için formülü girin.
Hesaplanmış alan oluşturmak için “tamam"a tıklayın.
Yeni hesaplanmış alan, Değerler bölümü altında PivotTable Alan Listesinde görünecektir.
Hesaplanmış alanı PivotTable’ın Değerler bölümüne sürükleyerek hesaplanmış değerleri görüntüleyin.

C# Kullanarak Pivot Tablosunda Hesaplanmış Alan Ekleme

Aspose.Cells kullanarak Excel dosyasına hesaplanmış alan eklemek. Örnek kodu yürüttükten sonra, hesaplanmış bir alan içeren bir pivot tablo oluşturulur.

Orijinal verileri ayarlayın ve bir pivot tablosu oluşturun.
Mevcut PivotField’a göre hesaplanmış alanı oluşturun.
Hesaplanmış alanı veri alanına ekleyin.
Son olarak, çalışma kitabını çıktı XLSX formatında kaydeder.

Örnek Kod

Net: Aspose.Cells for .NET'te PivotTable'lara stil uygulama

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, hem eski özet tablo otomatik biçimlerini (.xls dosyaları için tasarlanmış) hem de modern adlandırılmış veya özel özet tablo stillerini (.xlsx, .xlsm ve .xlsb dosyaları için tasarlanmış) uygulamayı destekler. Çağırmanız gereken API, çalışma kitabının içinden yüklendiği biçime değil, kaydedildiği dosya biçimine bağlıdır.

Giriş

Aspose.Cells, özet tablolar için iki paralel stil API’si sunar. Aralarındaki seçim, çalışma kitabını hangi dosya biçiminde kaydettiğinize bağlıdır; okuduğunuz biçime değil. Bir .xls dosyasından yüklenen çalışma kitabı .xlsx olarak yeniden kaydedilebilir ve bu durumda eski API yerine modern stil API’si geçerli olur.

Eski .xls çıktısı için Aspose.Cells.Pivot.PivotTableAutoFormatType numaralandırmasıyla birlikte PivotTable.AutoFormatType özelliğini kullanın. Bu API, klasik Excel’in özet tablolar için sunduğu otomatik biçim seçicisine karşılık gelir.

Modern .xlsx, .xlsm ve .xlsb çıktısı için iki çeşit stil API’si mevcuttur:

PivotTable.PivotTableStyleType, yerleşik adlandırılmış stillerden birini seçer (açık ve koyu temalar, Excel 2017’de eklenen stiller dahil). Bu ön ayarlar salt okunurdur.
PivotTable.PivotTableStyleName, Workbook.Worksheets.TableStyles.AddPivotTableStyle(...) aracılığıyla kendinizin tanımladığı özel bir stili seçer. Ön ayarların sunduğundan farklı renk, kenarlık veya yazı tipi değişiklikleri yapmak istediğinizde özel stiller gereklidir.

Bunlara ek olarak, PivotTable.FormatAll(Style), tek bir Style nesnesini pivotun her hücresine uygulayan, yukarıdaki stil adı API’leriyle ayarlanan her şeyi geçersiz kılan bir kısayoldur. Bu, alttaki tema dikkate alınmaksızın tek tip bir görünüm gerektiğinde yararlıdır.

Eski Bir XLS Ön Ayar Otomatik Biçimi Uygulama

PivotTable.AutoFormatType, Aspose.Cells.Pivot.PivotTableAutoFormatType numaralandırmasından bir değer kabul eder. Kullanılabilir değerler Report1 ile Report10 arası, Classic ve Table1 ile Table10 arası değerlerdir.

AutoFormatType yalnızca çalışma kitabı .xls olarak kaydedildiğinde dikkate alınır. Aynı çalışma kitabı .xlsx, .xlsm veya .xlsb olarak kaydedildiğinde, Excel bu özelliği yoksayar ve PivotTableStyleType ile PivotTableStyleName ayarlarına geri döner.

Aşağıdaki örnek, yeni bir çalışma kitabı yükler, Fruit/Year/Amount örnek verilerini doldurur, bir özet tablo ekler, PivotTableAutoFormatType.Report5‘i uygular ve sonucu .xls olarak kaydeder.

Neden sütun alanı yok? Report serisi otomatik biçimleri (Report1–Report10, Table1–Table10), klasik Excel’de yalnızca satır alanları ve değerler içeren tek boyutlu özet tablolar için tasarlanmıştı — sütun alanı başlıkları için yerleşik bir biçimlendirmeleri yoktur. Özet tablonuzun sütun alanlarına ihtiyacı varsa, bunun yerine aşağıdaki Senaryo 2’deki modern PivotTableStyleType ön ayarlarını kullanın; bunlar modern Excel’in kullandığı iki boyutlu düzen için tasarlanmıştır.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Senaryo 1: Eski bir XLS ön ayar otomatik biçimini uygula
// Kullanılan API: PivotTable.AutoFormatType
// Hedef dosya biçimi: .xls (eski)
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

// Yeni bir çalışma kitabı oluştur
Workbook workbook = new Workbook();

// İlk çalışma sayfasını al
Worksheet sheet = workbook.Worksheets[0];

// Kaynak verileri başlık satırıyla doldur (Meyve, Yıl, Tutar)
// ve 2020 ve 2021 yılları arasında üzüm, yaban mersini, kivi, kiraz'ı kapsayan 9 veri satırı
sheet.Cells[0, 0].PutValue("Fruit");
sheet.Cells[0, 1].PutValue("Year");
sheet.Cells[0, 2].PutValue("Amount");

sheet.Cells[1, 0].PutValue("grape");
sheet.Cells[1, 1].PutValue(2020);
sheet.Cells[1, 2].PutValue(50);

sheet.Cells[2, 0].PutValue("blueberry");
sheet.Cells[2, 1].PutValue(2020);
sheet.Cells[2, 2].PutValue(30);

sheet.Cells[3, 0].PutValue("kiwi");
sheet.Cells[3, 1].PutValue(2020);
sheet.Cells[3, 2].PutValue(25);

sheet.Cells[4, 0].PutValue("cherry");
sheet.Cells[4, 1].PutValue(2020);
sheet.Cells[4, 2].PutValue(40);

sheet.Cells[5, 0].PutValue("grape");
sheet.Cells[5, 1].PutValue(2021);
sheet.Cells[5, 2].PutValue(60);

sheet.Cells[6, 0].PutValue("blueberry");
sheet.Cells[6, 1].PutValue(2021);
sheet.Cells[6, 2].PutValue(35);

sheet.Cells[7, 0].PutValue("kiwi");
sheet.Cells[7, 1].PutValue(2021);
sheet.Cells[7, 2].PutValue(28);

sheet.Cells[8, 0].PutValue("cherry");
sheet.Cells[8, 1].PutValue(2021);
sheet.Cells[8, 2].PutValue(45);

sheet.Cells[9, 0].PutValue("grape");
sheet.Cells[9, 1].PutValue(2020);
sheet.Cells[9, 2].PutValue(45);

// Hedef hücre E3'te, "Pivot1" adında, A1:C10 kaynak aralığını kullanan bir pivot tablo ekle
int pivotIndex = sheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = sheet.PivotTables[pivotIndex];

// Alanları ata: Meyve -> Satırlar, Yıl -> Sütunlar, Tutar -> Veri
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// Eski XLS ön ayar otomatik biçimi "Report5" uygula
// Not: Bu özellik yalnızca .xls olarak kaydederken anlamlıdır.
// .xlsx/.xlsm/.xlsb olarak kaydedildiğinde, Excel AutoFormatType'ı yok sayar
// ve PivotTableStyleType / PivotTableStyleName'in belirttiği her şeyi kullanır.
pivotTable.AutoFormatType = PivotTableAutoFormatType.Report5;

// Çalışma kitabını eski .xls biçiminde kaydet
workbook.Save("output.xls");

Modern Adlandırılmış Ön Ayar Özet Tablo Stili Uygulama

PivotTable.PivotTableStyleType, Aspose.Cells.PivotTableStyleType numaralandırmasından bir değer kabul eder. Numaralandırma, PivotTableStyleLight1 ile PivotTableStyleLight28 arası açık temaları ve PivotTableStyleDark1 ile PivotTableStyleDark28 arası koyu temaları kapsar. Excel 2017’de eklenen stiller (açık ve koyu temaların ikinci dalgası) aynı numaralandırma üzerinden erişilebilir.

Bu, herhangi bir modern dosya biçimi için önerilen API’dir. Eski otomatik biçimden farklı olarak, burada seçilen stil Excel tarafından aslına sadık şekilde işlenir ve diğer Office araçlarıyla yapılan gidiş-dönüşlerde de korunur.

Aşağıdaki örnek aynı Fruit/Year/Amount verilerini kullanır, özdeş bir özet tablo oluşturur, PivotTableStyleDark1 uygular ve çalışma kitabını .xlsx olarak kaydeder.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Senaryo 2: PivotTableStyleType kullanarak modern bir Excel 2007+ adlandırılmış hazır stili uygulayın.
// Hedef dosya formatı: .xlsx. PivotTableStyleType numaralandırması Aspose.Cells ad alanında bulunur
// (Aspose.Cells.Pivot içinde değil) — bu yüzden ek bir using'e ihtiyacımız yok.
// GitHub referansı: https://github.com/aspose-cells/Aspose.Cells-for-.NET/blob/master/Examples/CSharp/PivotTables/ApplyStyleToPivotTable2.cs

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// Başlık satırı: Fruit / Year / Amount
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 9 veri satırı: Fruit / Year / Amount
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(150);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(200);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(180);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(120);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(170);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(210);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(190);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(130);

// E3 konumunda "Pivot1" adında bir pivot tablo ekleyin, kaynak A1:C10
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// Pivot alanlarını atayın: Fruit -> Satır alanı, Year -> Sütun alanı, Amount -> Veri alanı
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// Modern bir Excel 2007+ adlandırılmış hazır pivot stili uygulayın.
// PivotTableStyleType, .xlsx / .xlsm / .xlsb dosyaları için doğru API'dir; AutoFormatType
// bu formatlar için Excel tarafından yok sayılır. PivotTableStyleDark1, koyu tema
// ailesine aittir (PivotTableStyleDark1..PivotTableStyleDark28) ve aynı numaralandırma ayrıca
// daha yeni Excel 2017 açık/koyu temalarını da sunar (PivotTableStyleLight1..Light28 / Dark1..Dark28).
pivotTable.PivotTableStyleType = PivotTableStyleType.PivotTableStyleDark1;

// Modern .xlsx olarak kaydedin — PivotTableStyleType'ın anlamlı olduğu format budur.
workbook.Save("output.xlsx");

Özel Bir Özet Tablo Stili Tanımlama ve Uygulama

Yerleşik ön ayarlar değiştirilemez. Renkleri, kenarlıkları veya yazı tiplerini geçersiz kılmanız gerektiğinde özel bir özet stili tanımlamalısınız. İş akışı üç adımdan oluşur:

Workbook.Worksheets.TableStyles.AddPivotTableStyle(string name) aracılığıyla çalışma kitabının TableStyles koleksiyonuna özel bir stil ekleyin. Bu, yeni oluşturulan stilin dizinini döndürür.
TableStyle.TableStyleElements.Add(TableStyleElementType) aracılığıyla öğeler (örneğin WholeTable veya GrandTotalRow) ekleyerek stili yapılandırın, ardından her öğeye TableStyleElement.SetElementStyle(Style) aracılığıyla bir Style atayın.
PivotTable.PivotTableStyleName‘i stilin adına ayarlayarak özel stili özet tabloya uygulayın. Bu özellik yerleşik ön ayarları seçtiğinden burada PivotTableStyleType‘ı kullanmayın.

PivotTableStyleName ve PivotTableStyleType birbirinin yerine kullanılamaz. Yerleşik ön ayarlar için PivotTableStyleType‘ı ve AddPivotTableStyle aracılığıyla tanımladığınız özel stiller için PivotTableStyleName‘i kullanın. İkisini birden ayarlamak zararsızdır, ancak yalnızca amaçlanan kaynağa uygun olan işlenir.

Kullanılabilir TableStyleElementType değerleri arasında WholeTable, FirstRow, LastRow, FirstColumn, LastColumn, GrandTotalRow, GrandTotalColumn, PageFieldLabels ve PageFieldValues bulunur.

Aşağıdaki örnek, WholeTable üzerinde ince siyah kenarlığa ve GrandTotalRow üzerinde kalın kırmızı yazı tipine sahip özel bir özet stili tanımlar, ardından bunu PivotTableStyleName aracılığıyla uygular ve .xlsx olarak kaydeder.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;
using System.Drawing;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// Kaynak verileri doldur: başlık satırı + 9 veri satırı (A1:C10)
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(500);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(600);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(700);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(800);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(900);

// A1:C10'dan kaynaklanan, E3'e sabitlenmiş, "Pivot1" adlı pivot tablo ekle
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// Adım 1: yeni bir özel pivot tablo stili kaydet ve dizinini yakala
int styleIndex = workbook.Worksheets.TableStyles.AddPivotTableStyle("CustomPivotStyle");
TableStyle tableStyle = workbook.Worksheets.TableStyles[styleIndex];

// Adım 2: bir WholeTable öğesi ekle ve dört kenara ince siyah kenarlıklar uygula
int wholeTableElementIndex = tableStyle.TableStyleElements.Add(TableStyleElementType.WholeTable);
TableStyleElement wholeTableElement = tableStyle.TableStyleElements[wholeTableElementIndex];
Style wholeTableStyle = workbook.CreateStyle();
wholeTableStyle.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.TopBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.BottomBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.LeftBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.RightBorder].Color = Color.Black;
wholeTableElement.SetElementStyle(wholeTableStyle);

// Adım 3: bir GrandTotalRow öğesi ekle ve kırmızı kalın yazı tipi uygula
int grandTotalElementIndex = tableStyle.TableStyleElements.Add(TableStyleElementType.GrandTotalRow);
TableStyleElement grandTotalElement = tableStyle.TableStyleElements[grandTotalElementIndex];
Style grandTotalStyle = workbook.CreateStyle();
grandTotalStyle.Font.IsBold = true;
grandTotalStyle.Font.Color = Color.Red;
grandTotalElement.SetElementStyle(grandTotalStyle);

// Adım 4: özel stili ada göre uygula (PivotTableStyleType DEĞİL, bu yerleşik ön ayarlar içindir)
pivotTable.PivotTableStyleName = "CustomPivotStyle";

workbook.Save("output.xlsx");

FormatAll ile Her Pivot Hücresine Tek Bir Stil Uygulama

PivotTable.FormatAll(Style), tek bir Style nesnesini veri alanı, satır ve sütun başlıkları ile toplamlar dahil olmak üzere özet tablonun her hücresine uygulayan bir kısayoldur. PivotTableStyleType veya PivotTableStyleName aracılığıyla daha önce ayarlanmış olan her şey geçersiz kılınır.

FormatAll, hem PivotTableStyleType hem de PivotTableStyleName öğelerini geçersiz kılar. Yalnızca tüm pivot genelinde temadan bağımsız tek tip bir görünüm gerektiğinde kullanın.

Aşağıdaki örnek, sarı düz dolguya, kalın koyu mavi yazı tipine ve tüm kenarlarda ince siyah kenarlıklara sahip bir Style oluşturur, ardından bunu FormatAll ile uygular ve .xlsx olarak kaydeder.

using System;
using System.Drawing;
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Senaryo 4: FormatAll kullanarak her pivot tablo hücresine tek bir Stil uygulama
// Kullanılan API: PivotTable.FormatAll(Style)
// Hedef format: .xlsx
// GitHub referansı: Aspose.Cells-for-.NET deposuna bakın — pivot tablo stil örnekleri

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// Kaynak verileri doldur: başlık satırı (satır 1) + 9 veri satırı (satır 2-10)
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(5000);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(3000);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(4000);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(2000);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(6000);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(3500);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(4500);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(2500);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(5500);

// Pivot tablo ekle: kaynak aralık A1:C10, hedef hücre E3, ad "Pivot1"
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// Pivot alanlarını ata: Fruit -> Satır alanı, Year -> Sütun alanı, Amount -> Veri alanı
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// Pivot tablonun her hücresine zorla uygulanacak bir Stil oluştur
Style style = workbook.CreateStyle();
style.ForegroundColor = Color.Yellow;
style.Pattern = BackgroundType.Solid;
style.Font.IsBold = true;
style.Font.Color = Color.DarkBlue;
style.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.TopBorder].Color = Color.Black;
style.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.BottomBorder].Color = Color.Black;
style.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.LeftBorder].Color = Color.Black;
style.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.RightBorder].Color = Color.Black;

// FormatAll uygula: bu tek stili pivot tablonun her hücresine zorlar,
// önceden ayarlanmış tüm PivotTableStyleType / PivotTableStyleName ayarlarını geçersiz kılar
pivotTable.FormatAll(style);

// Çalışma kitabını modern .xlsx formatında kaydet
workbook.Save("output.xlsx");

Hangi Stil API’sini Kullanmalıyım?

Stil API’si seçimi, kaydettiğiniz dosya biçimine bağlıdır. Hızlı bir başvuru olarak aşağıdaki tabloyu kullanın.

Hedef dosya biçimi	Kullanılacak API	Notlar
`.xls` (eski)	`PivotTable.AutoFormatType`	`Aspose.Cells.Pivot.PivotTableAutoFormatType` değerleri (örn. `Report1`–`Report10`, `Classic`, `Table1`–`Table10`). Modern biçimlerde kaydederken yoksayılır.
`.xlsx` / `.xlsm` / `.xlsb` (modern, yerleşik stil)	`PivotTable.PivotTableStyleType`	`Aspose.Cells.PivotTableStyleType` değerleri (açık/koyu temalar, Excel 2017 eklemeleri dahil).
`.xlsx` / `.xlsm` / `.xlsb` (modern, özel stil)	`PivotTable.PivotTableStyleName` + `Worksheets.TableStyles.AddPivotTableStyle(...)`	Yerleşik ön ayarlar yeterli olmadığında kullanın. `TableStyleElement.SetElementStyle(...)` aracılığıyla yapılandırın.
Herhangi bir biçim (tek tip geçersiz kılma)	`PivotTable.FormatAll(Style)`	Tüm pivot genelinde diğer tüm stil ayarlarını geçersiz kılan kısayol.

Kararsız kaldığınızda, .xlsx olarak kaydedin ve yerleşik temalar için PivotTableStyleType‘ı veya özel temalar için PivotTableStyleName‘i kullanın.

Net: Aspose.Cells for .NET'te PivotTable'ları ve PivotTable önbelleklerini yenileme

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, dört farklı kapsamda — çalışma kitabının tamamından tek bir özet tablosuna kadar — pivot verilerini yeniden yüklemenizi sağlayan katmanlı bir yenileme API’si sunar. Aspose.Cells for .NET v26.7 sürümünden itibaren, eski yöntem olan PivotTable.RefreshData() kullanımdan kaldırılmış (obsolete) olarak işaretlenmiş olup bu makalede açıklanan daha verimli, önbellek farkındalığına sahip API’ler ile değiştirilmelidir.

Giriş

Bir özet tablosunu yenileme nadiren tek bir işlemdir. Sahne arkasında Aspose.Cells, orijinal kaynak verilerinizi çalışma sayfasında gördüğünüz işlenmiş değerlere bağlayan katmanlı bir veri zinciri tutar. Bu zinciri anlamak, her durum için doğru yenileme API’sini seçmenin anahtarıdır.

Dört katmanlı veri zinciri şudur:

Veri Kaynağı — ham değerlerin bulunduğu orijinal çalışma sayfası aralıkları, veritabanı sorgusu veya konsolidasyon aralığı.
PivotCache — kaynak verilerin bellek içi anlık görüntüsü. Her özet tablosu bir PivotCache üzerine inşa edilir; tüm verilerin toplandığı ve toplulaştırıldığı yer burasıdır.
PivotTable — satır, sütun, değer ve filtre alanlarını tanımlayan görünüm nesnesi. Bir PivotTable verileri yalnızca kendi PivotCache‘inden okur, doğrudan veri kaynağından asla okumaz.
Cells — PivotTable‘ın hesaplanmış değerlerini ve stillerini işlediği çalışma sayfası Cells koleksiyonu.

Özellikle önemli bir kavram paylaşılan önbellektir. Bir çalışma kitabındaki birden çok özet tablosu aynı kaynak aralığa başvurduğunda, tek bir PivotCache örneğini paylaşırlar. Tek bir PivotCache‘e birçok özet tablosu tarafından başvurulabilir ve bu önbelleği yenilemek, ona bağlı olan her PivotTable‘ı bir defada yeniler.

PivotCache.SourceType (enum PivotTableSourceType), önbellek verilerinin nereden geldiğini belirtir. v26.7 itibarıyla, PivotCache.Refresh() yalnızca Sheet ve Consolidation kaynak türlerini destekler — yani çalışma sayfası aralıklarında yaşayan verileri. Dış kaynaklar (veritabanları, dış bağlantılar vb.) henüz önbellek API’si aracılığıyla yenilenemez.

Bu zincir nedeniyle, Aspose.Cells’te iki temel yenileme yolu vardır:

PivotCache.Refresh() — kaynak → önbelleği yeniden yükler VE tek bir işlemde tüm bağımlı PivotTable‘ları yeniden hesaplar.
PivotTable.CalculateData() — veri kaynağına geri dönmeden, zaten önbelleğe alınmış verilerden tek bir PivotTable‘ın görünümünü yeniden hesaplar.

Bu makaledeki tüm senaryolar çalışma sayfası hücre kaynak verilerini kullanır, dolayısıyla kaynak türü Sheet‘tir ve yenileme işlemleri açıklandığı gibi çalışır.

Gerekli Using Direktifleri

Bu makaledeki tüm C# örnekleri, pivot türlerinin Aspose.Cells.Pivot namespace’inde bulunması nedeniyle aşağıdaki üç using direktifi ile başlar:

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Çalışma Kitabındaki Tüm Özet Tablolarını Yenileme

Çalışma kitabındaki her pivot önbelleğinin ve her özet tablosunun en son kaynak verileri yansıtmasını sağlamanız gerektiğinde, en basit ve en kapsamlı API Workbook.RefreshAll() yöntemidir. Tek bir çağrı tüm çalışma kitabını dolaşır — her PivotCache‘i kaynağından yeniler ve ardından bağımlı olan her PivotTable‘ı yeniden hesaplar. Performansın önemli olmadığı genel, tam belge yenilemeleri için önerilen yaklaşımdır.

Aşağıdaki örnek, Fruit/Year/Amount kaynak aralığına sahip bir çalışma kitabı oluşturur, bir özet tablosu oluşturur, bazı kaynak değerlerini değiştirir ve ardından tek bir çağrıda her şeyi güncellemek için RefreshAll() yöntemini kullanır.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Yeni bir çalışma kitabı oluştur
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// A1:C1 hücrelerine başlık satırını yaz
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// A2:C9 hücrelerine veri satırlarını yaz (2020 ve 2021 yıllarına ait 8 satır meyve verisi)
worksheet.Cells["A2"].PutValue("grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(50);

worksheet.Cells["A3"].PutValue("blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(60);

worksheet.Cells["A4"].PutValue("kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(70);

worksheet.Cells["A5"].PutValue("cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(80);

worksheet.Cells["A6"].PutValue("grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(90);

worksheet.Cells["A7"].PutValue("blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(100);

worksheet.Cells["A8"].PutValue("kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(110);

worksheet.Cells["A9"].PutValue("cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(120);

// Özet tablo ekle: kaynak aralık "A1:C9", hedef hücre "E3", ad "Pivot1"
int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// Pivot alanlarını ata: Satırlar'a Fruit, Sütunlar'a Year, Veri'ye Amount
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// Değişiklikleri simüle etmek için kaynak verilerdeki birkaç Amount değerini değiştir
worksheet.Cells["C2"].PutValue(55);
worksheet.Cells["C5"].PutValue(85);
worksheet.Cells["C9"].PutValue(125);

// Çalışma kitabındaki tüm özet tabloları / özet önbelleklerini yenile
workbook.RefreshAll();

// Çalışma kitabını kaydet
workbook.Save("output.xlsx");

Tek Bir Çalışma Sayfasındaki Tüm Özet Tablolarını Yenileme

Bazen yalnızca belirli bir çalışma sayfasında bulunan özet tablolarını yenilemeniz gerekebilir — örneğin, diğer çalışma sayfalarındaki özet tablolarının ilgisiz olduğu biliniyor ve bunlara dokunulmaması gerektiğinde. Bu durum için Aspose.Cells, tek bir Worksheet örneğiyle sınırlı olan Worksheet.RefreshPivotTables() yöntemini sağlar.

Bu yöntem Workbook.RefreshAll() yönteminden daha seçicidir: yalnızca hedeflenen çalışma sayfasındaki özet tabloları yenilenir, diğer çalışma sayfalarındaki özet tablolarına dokunulmaz.

Aşağıdaki örnek aynı Fruit/Year/Amount kaynak verilerini doldurur, ilk çalışma sayfasına bir özet tablosu ekler, bazı kaynak değerlerini değiştirir ve ardından yalnızca o çalışma sayfasındaki özet tablolarını yeniler.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("blueberry");
worksheet.Cells["B3"].PutValue(2021);
worksheet.Cells["C3"].PutValue(150);

worksheet.Cells["A4"].PutValue("kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(200);

worksheet.Cells["A5"].PutValue("cherry");
worksheet.Cells["B5"].PutValue(2021);
worksheet.Cells["C5"].PutValue(120);

worksheet.Cells["A6"].PutValue("grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(180);

worksheet.Cells["A7"].PutValue("blueberry");
worksheet.Cells["B7"].PutValue(2020);
worksheet.Cells["C7"].PutValue(130);

worksheet.Cells["A8"].PutValue("kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(220);

worksheet.Cells["A9"].PutValue("cherry");
worksheet.Cells["B9"].PutValue(2020);
worksheet.Cells["C9"].PutValue(140);

int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

worksheet.Cells["C2"].PutValue(300);
worksheet.Cells["C5"].PutValue(250);
worksheet.Cells["C9"].PutValue(400);

worksheet.RefreshPivotTables();

workbook.Save("output.xlsx");

Tek Bir Özet Tablosunu Yenileme

Tek bir özet tablosu üzerinde ayrıntılı denetim istediğinizde, önbellek tabanlı API size iki seçenek sunar. Aralarındaki seçim, gerçekte neyin değiştiğine bağlıdır: temel kaynak veriler mi, yoksa yalnızca özet tablosunun kendi görünüm/düzen ayarları mı.

Kaynak Veriler Değişti — `PivotCache.Refresh()` Kullanın

Temel kaynak veriler değiştiyse, doğru giriş noktası pivotTable.PivotCache.Refresh() yöntemidir. Bu çağrı, kaynak verileri önbelleğe yeniden okur ve ardından o önbelleğe bağlı olan her PivotTable‘ı yeniden hesaplar.

Özet tabloları tek bir PivotCache örneğini paylaştığı için, PivotCache.Refresh() çağrısı, başvurduğunuz tabloyu değil, aynı önbellek üzerine inşa edilmiş tüm özet tablolarını yeniden hesaplar. İki özet tablosu aynı kaynak aralığını paylaşıyorsa, bir önbelleği yenilemek her ikisini de yeniler.

Aşağıdaki örnek, paylaşılan önbellek davranışını göstermek için aynı kaynak aralığa sahip iki özet tablosu oluşturur, bazı kaynak değerlerini değiştirir ve ardından tek bir önbellek başvurusu üzerinden yenileme yapar.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Yeni bir çalışma kitabı oluştur ve ilk çalışma sayfasına eriş
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// Başlık satırını yaz: Meyve / Yıl / Tutar
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// Yaklaşık 9 veri satırı yaz (üzüm / yaban mersini / kivi / kiraz, 2020-2021 arası)
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(500);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(600);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(700);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(800);

// E3 hücresine sabitlenmiş, kaynak aralığı A1:C9 olan ilk "Pivot1" pivot tablosunu ekle
int pivotIndex1 = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable1 = worksheet.PivotTables[pivotIndex1];

// Pivot1 için alanları ata
pivotTable1.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable1.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable1.AddFieldToArea(PivotFieldType.Data, "Amount");

// E15 hücresine sabitlenmiş, AYNI A1:C9 kaynak aralığını kullanan İKİNCİ "Pivot2" pivot tablosunu ekle
// Pivot1 ve Pivot2, kaynak aralığı aynı olduğundan tek bir PivotCache'i paylaşır.
int pivotIndex2 = worksheet.PivotTables.Add("A1:C9", "E15", "Pivot2");
PivotTable pivotTable2 = worksheet.PivotTables[pivotIndex2];

// Pivot2 için aynı alanları ata
pivotTable2.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable2.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable2.AddFieldToArea(PivotFieldType.Data, "Amount");

// Bir veri değişikliğini simüle etmek için kaynak verilerdeki birkaç Tutar hücre değerini değiştir
worksheet.Cells["C2"].PutValue(150);
worksheet.Cells["C4"].PutValue(350);
worksheet.Cells["C7"].PutValue(650);

// Paylaşılan PivotCache'i yenile.
// Pivot1 ve Pivot2 aynı PivotCache'i paylaştığından, bu tek çağrı
// güncellenmiş kaynaktan HER İKİ pivot tablosunu da (veri + stil) yeniler.
pivotTable1.PivotCache.Refresh();

// Çalışma kitabını kaydet
workbook.Save("output.xlsx");

Yalnızca Görünüm/Düzen Değişti — `CalculateData()` Kullanın

Kaynak veriler değişmediyse ancak yalnızca özet tablosunun görünüm veya düzen ayarları değiştirildiyse (örneğin, bir alan farklı bir alana taşındıysa veya açılışta yenileme ayarı değiştirildiyse), veri kaynağına geri dönmek gerekmez. Önbellek zaten doğru verileri tutuyor; yalnızca işlenmiş PivotTable‘ın yeniden hesaplanması gerekiyor. Bu durumda pivotTable.CalculateData() doğru seçimdir.

Bu, gereksiz kaynak getirme işlemini önler ve birçok özet tablosu aynı önbelleği paylaştığında önemli ölçüde daha hızlıdır.

Aşağıdaki örnek, özet tablosunun kaynak olmayan bir özelliğini değiştirir ve ardından mevcut önbellekten yeniden işlemek için CalculateData() yöntemini çağırır.

using Aspose.Cells;
using Aspose.Cells.Pivot;

var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];

// Fruit / Yıl / Tutar başlık satırını yaz
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 8 veri satırı yaz (2-9 arası satırlar, A1:C9 kaynak aralığına uygun)
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(150);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(250);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(350);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(450);

// "Pivot1" adlı bir pivot tablo ekle, E3 hedef hücresine yerleştirilir, A1:C9 kaynağından alınır
int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.PivotTables[pivotIndex];

// Alanları ata: Fruit Satır'a, Year Sütun'a, Amount Veri'ye
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// Bir görünüm/düzen özelliğini değiştir — bu yalnızca bir sunum değişikliğidir,
// bu nedenle PivotCache.Refresh() aracılığıyla kaynak verilerin yeniden okunmasını GEREKTİRMEZ.
pivotTable.RefreshDataOnOpeningFile = false;

// CalculateData() BU pivot tablonun görüntüsünü (veri + stil) PivotCache'te
// zaten tutulan verilerden yeniden oluşturur. Kaynak veri değişmediğinden,
// kaynağa gidiş-dönüş yapılmaz — yalnızca önbelleğe alınmış değerler yeniden hesaplanır
// çalışma sayfası hücrelerine aktarılır.
pivotTable.CalculateData();

// Çalışma kitabını diske kaydet
workbook.Save("output.xlsx");

Aynı PivotCache’i Paylaşan Tüm Özet Tablolarını Alma

Bir çalışma kitabı genellikle tek bir paylaşılan önbelleğin üzerine oturan birçok özet tablosu içerir. Bunları numaralandırmak için — örneğin toplu bir yenileme gerçekleştirmeden önce veya paylaşılan önbellek etkisini tanılamak için — PivotCache.GetPivotTables() yöntemini kullanın. Bu yöntem, verilen önbelleğe bağlı olan her PivotTable‘ın koleksiyonunu döndürür.

Bu, aynı zamanda iki özet tablosunun gerçekten aynı PivotCache örneğini paylaştığını doğrulamanın en doğrudan yoludur: önbellek başvurularını karşılaştırabilir veya basitçe GetPivotTables() tarafından döndürülen koleksiyonu yineleyerek hangi özet tablolarının bu koleksiyonda göründüğünü gözlemleyebilirsiniz.

Aşağıdaki örnek, aynı kaynak aralığa sahip iki özet tablosu oluşturur, aynı önbellek örneğini paylaştıklarını doğrular ve ardından önbelleğin özet tablolarını numaralandırır.

Kullanımdan Kaldırılan `PivotTable.RefreshData()`‘dan Geçiş

Aspose.Cells for .NET v26.7’den önce, bir özet tablosunu yenilemenin standart yolu her özet tablosunda ayrı ayrı PivotTable.RefreshData() çağrısı yapmaktı. v26.7 itibarıyla, bu yöntem kullanımdan kaldırılmış olarak işaretlenmiştir ve yukarıda açıklanan önbellek farkındalığına sahip API’ler ile değiştirilmelidir.

Tablo başına RefreshData() yaklaşımının gerçek dünya çalışma kitaplarında sorunlu olmasının iki nedeni vardır:

Kaynak değişmemiş olsa bile her çağrıldığında verileri kaynaktan yeniden getirir.
Her çağrı tüm paylaşılan önbelleği yeniler. Birçok özet tablosu tek bir önbelleği paylaştığında, özet tablosu başına tekrar tekrar RefreshData() çağrısı yapmak aynı önbelleğin tekrar tekrar yeniden getirilmesine neden olur; bu da çok yavaştır.

Önerilen alternatifler şunlardır:

Çalışma kitabındaki TÜM özet tablolarını yenileme → workbook.RefreshAll(); kullanın
Bazılarını yenileme → tek bir önbellek için pivotTable.PivotCache.Refresh(); kullanın. Önbellek paylaşıldığından, bu tek çağrı o önbelleğin üzerine inşa edilmiş her özet tablosunu günceller. Zaten yenilenmiş bir önbelleğin üzerine oturan diğer özet tabloları güvenle atlanabilir.
Yalnızca pivot görünümü/düzeni değişti → kaynaktan herhangi bir geri dönüş olmadan mevcut önbellekten yeniden işlemek için pivotTable.CalculateData(); kullanın.

Aşağıdaki örnek, tek bir önbelleği paylaşan birden çok özet tablosuna sahip çalışma kitapları için yeni verimli kalıbı göstermektedir.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Yeni bir çalışma kitabı oluştur ve ilk çalışma sayfasına eriş
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

// --- Kaynak veriyi oluştur: Meyve / Yıl / Tutar (başlık + 9 satır) ---
sheet.Cells["A1"].PutValue("Fruit");
sheet.Cells["B1"].PutValue("Year");
sheet.Cells["C1"].PutValue("Amount");

sheet.Cells["A2"].PutValue("Grape");      sheet.Cells["B2"].PutValue(2020); sheet.Cells["C2"].PutValue(1000);
sheet.Cells["A3"].PutValue("Blueberry");  sheet.Cells["B3"].PutValue(2020); sheet.Cells["C3"].PutValue(2000);
sheet.Cells["A4"].PutValue("Kiwi");       sheet.Cells["B4"].PutValue(2020); sheet.Cells["C4"].PutValue(1500);
sheet.Cells["A5"].PutValue("Cherry");     sheet.Cells["B5"].PutValue(2020); sheet.Cells["C5"].PutValue(2500);
sheet.Cells["A6"].PutValue("Grape");      sheet.Cells["B6"].PutValue(2021); sheet.Cells["C6"].PutValue(3000);
sheet.Cells["A7"].PutValue("Blueberry");  sheet.Cells["B7"].PutValue(2021); sheet.Cells["C7"].PutValue(1800);
sheet.Cells["A8"].PutValue("Kiwi");       sheet.Cells["B8"].PutValue(2021); sheet.Cells["C8"].PutValue(2200);
sheet.Cells["A9"].PutValue("Cherry");     sheet.Cells["B9"].PutValue(2021); sheet.Cells["C9"].PutValue(2700);

// --- İlk pivot tablosunu (Pivot1) E3 hedef hücresine ekle ---
int idx1 = sheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable1 = sheet.PivotTables[idx1];
pivotTable1.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable1.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable1.AddFieldToArea(PivotFieldType.Data, "Amount");

// --- İKİNCİ pivot tablosunu (Pivot2) AYNI kaynak aralığında ekle ---
// Hem Pivot1 hem de Pivot2, TEK bir temel PivotCache'i paylaşır.
// Eski tablo başına RefreshData() yaklaşımının verimsiz hale geldiği senaryo tam olarak budur:
// bir tabloyu yenilemek tüm paylaşılan önbelleği yeniden çeker,
// bu nedenle N tabloyu yenilemek aynı pahalı çekme işlemini N kez yapar.
int idx2 = sheet.PivotTables.Add("A1:C9", "E15", "Pivot2");
PivotTable pivotTable2 = sheet.PivotTables[idx2];
pivotTable2.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable2.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable2.AddFieldToArea(PivotFieldType.Data, "Amount");

// --- Kaynak verideki birkaç Tutar değerini değiştir ---
sheet.Cells["C2"].PutValue(5000);   // Üzüm 2020
sheet.Cells["C5"].PutValue(7500);   // Kiraz 2020
sheet.Cells["C9"].PutValue(9500);   // Kiraz 2021

// --- KULLIMDAN KALDIRILMIŞ kalıp (26.7 öncesi) — PivotTable.RefreshData() ---
// pivotTable1.RefreshData();  // kaynaktan yeniden çeker, tüm önbelleği yeniler
// pivotTable2.RefreshData();  // TEKRAR yeniden çeker — önbellek zaten taze!
// Her çağrı paylaşılan önbelleği yeniden oluşturur, bu nedenle N tablo = N gereksiz çekme.

// --- YENİ v26.7+ kalıbı: önbelleği BİR KEZ yenile, ardından gerektiğinde yeniden işle ---
// PivotCache.Refresh() öğesine yapılan tek bir çağrı, değiştirilen değerleri paylaşılan
// önbelleğe çeker VE ona başvuran HER pivot tablosunun görüntüsünü yeniden hesaplar.
// Pivot1 ve Pivot2 tek bir PivotCache paylaştığından, bu tek çağrı her iki tabloyu da günceller
// — ikinci bir kaynak gidiş-dönüşü gerekmez.
pivotTable1.PivotCache.Refresh();

// CalculateData() yalnızca bir pivot tablosunun görüntüsünü (veri + stil) önbellekte
// zaten tutulan veriden yeniden işler — kaynağa DOKUNMAZ. Onu burada Pivot2 üzerinde
// yalnızca API'yi göstermek için çağırıyoruz: önbellek bir kez yenilendikten sonra,
// bağımlı herhangi bir tablo kaynağa geri dönmeden yeniden işlenebilir. CalculateData()'yı
// yalnızca pivot tablosunun görünüm/düzen ayarları değiştiğinde ve önbellek güncel olduğunda
// kendi başına kullanın.
pivotTable2.CalculateData();

workbook.Save("output.xlsx");

Hangi Yenileme API’sini Kullanmalıyım?

Aşağıdaki tablo, mevcut yenileme API’lerini özetlemekte ve her birinin ne zaman seçilmesi gerektiğini göstermektedir.

Amaç	Önerilen API	Notlar
Çalışma kitabındaki her şeyi yenileme	`Workbook.RefreshAll()`	Tek çağrı; tüm önbellekleri ve tabloları kapsar.
Yalnızca tek bir sayfadaki özet tablolarını yenileme	`Worksheet.RefreshPivotTables()`	Tek bir çalışma sayfasıyla sınırlı.
Bir önbellek için kaynak veriler değişti	`pivotTable.PivotCache.Refresh()`	O paylaşılan önbellek üzerindeki TÜM özet tablolarını yeniler.
Yalnızca görünüm/düzen ayarları değişti	`pivotTable.CalculateData()`	Gereksiz kaynak geri dönüşünü atlar.
Paylaşılan bir önbellekteki tüm özet tablolarını listeleme	`pivotCache.GetPivotTables()`	Toplu yenilemeden önce numaralandırmak için kullanın.

Pratikte, kullanımdan kaldırılan tablo başına RefreshData() yerine önbellek tabanlı API’leri tercih edin. Bunlar paylaşılan önbelleklerin farkındadır, gereksiz kaynak getirmelerinden kaçınır ve yenileme gereksiniminizi karşılayan en küçük kapsamı seçmenize olanak tanır.

Net: Aspose.Cells for .NET'te PivotTable'a satır ve sütun alanları ekleme

Mon, 01 Jan 0001 00:00:00 +0000

Satır veya Sütun Bölgesine Alan Ekleme

PivotTable.AddFieldToArea(PivotFieldType fieldType, string fieldName) yöntemi, kaynak verilerden bir temel alanı dört pivot bölgesinden birine taşır. fieldType argümanı aşağıdaki PivotFieldType değerlerinden birini kabul eder.

Row — sol tarafta dikey olarak yerleştirilen alanlar
Column — üstte yatay olarak yerleştirilen alanlar
Data — değerleri toplanan alanlar
Page — rapor filtreleri olarak kullanılan alanlar

Alanlar eklendikten sonra PivotTable.RowFields ve PivotTable.ColumnFields özellikleri aracılığıyla bunlara erişebilirsiniz. Her özellik bir PivotFieldCollection döndürür. RowFields koleksiyonunun 0 indeksindeki alan en dıştaki satır alanıdır ve sonraki indisler onun içine yerleştirilmiş alanları temsil eder. Aynı indeksleme kuralı ColumnFields için de geçerlidir.

Alan iç içe geçme sırası önemlidir. Önce Category alanını satır bölgesine, ardından Item alanını eklemek, dış gruplandırması Category ve iç gruplandırması Item olan bir pivot oluşturur. Sırayı tersine çevirmek hiyerarşiyi de tersine çevirir.

Pivot Alanı Alt Toplamları

PivotField.SetSubtotals(PivotFieldSubtotalType subtotalType, bool shown) yöntemi, bir pivot alanı için hangi alt toplam satırlarının görüneceğini kontrol eder. Her çağrı tek bir alt toplam türünü bağımsız olarak değiştirir. shown = true değerini geçmek alt toplamı gösterirken, shown = false değerini geçmek onu gizler. Her çağrı yalnızca bir türü etkilediğinden, yöntemi farklı subtotalType değerleriyle birden çok kez çağırmak özel bir alt toplam alt kümesi oluşturur.

PivotFieldSubtotalType numaralandırması kullanılabilir alt toplam türlerini tanımlar.

Automatic — Aspose.Cells varsayılan seçimi belirler (genellikle sayısal alanlar için Sum)
None — tüm alt toplam satırlarını gizler
Sum
Count
Average
Max
Min
Product
StdDev
StdDevp
Var
Varp

Alt toplamlar yalnızca satır bölgesinde (veya sütun bölgesinde) iki veya daha fazla pivot alanı olduğunda görüntülenir. Tek bir alanın arasında toplanacak anlamlı bir şey yoktur, dolayısıyla bu durumda SetSubtotals çağrılarının görünür bir etkisi olmaz. Bu nedenle bu makale, her Category grubu arasındaki alt toplam sınırının görünür olması için her örnekte iki satır alanı (Category dış, Item iç) yerleştirir.

Senaryo 1 — Otomatik (Varsayılan) Alt Toplamlar

Hiç SetSubtotals çağırmadığınızda Aspose.Cells sayısal alanlara Automatic seçimini uygular. Aşağıdaki örnek, dış Category satır alanı üzerinde SetSubtotals(PivotFieldSubtotalType.Automatic, true) çağırarak bu davranışı açıkça doğrular.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

worksheet.Cells[1, 0].PutValue("Fruit");
worksheet.Cells[1, 1].PutValue("Apple");
worksheet.Cells[1, 2].PutValue(2020);
worksheet.Cells[1, 3].PutValue(100);

worksheet.Cells[2, 0].PutValue("Fruit");
worksheet.Cells[2, 1].PutValue("Apple");
worksheet.Cells[2, 2].PutValue(2021);
worksheet.Cells[2, 3].PutValue(150);

worksheet.Cells[3, 0].PutValue("Fruit");
worksheet.Cells[3, 1].PutValue("Banana");
worksheet.Cells[3, 2].PutValue(2020);
worksheet.Cells[3, 3].PutValue(80);

worksheet.Cells[4, 0].PutValue("Fruit");
worksheet.Cells[4, 1].PutValue("Banana");
worksheet.Cells[4, 2].PutValue(2021);
worksheet.Cells[4, 3].PutValue(90);

worksheet.Cells[5, 0].PutValue("Vegetable");
worksheet.Cells[5, 1].PutValue("Carrot");
worksheet.Cells[5, 2].PutValue(2020);
worksheet.Cells[5, 3].PutValue(50);

worksheet.Cells[6, 0].PutValue("Vegetable");
worksheet.Cells[6, 1].PutValue("Carrot");
worksheet.Cells[6, 2].PutValue(2021);
worksheet.Cells[6, 3].PutValue(60);

worksheet.Cells[7, 0].PutValue("Vegetable");
worksheet.Cells[7, 1].PutValue("Daikon");
worksheet.Cells[7, 2].PutValue(2020);
worksheet.Cells[7, 3].PutValue(40);

worksheet.Cells[8, 0].PutValue("Vegetable");
worksheet.Cells[8, 1].PutValue("Daikon");
worksheet.Cells[8, 2].PutValue(2021);
worksheet.Cells[8, 3].PutValue(45);

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.Automatic, true);

pivotTable.CalculateData();

workbook.Save("output_automatic.xlsx");

Senaryo 2 — Tüm Alt Toplamları Gizleme (None)

SetSubtotals(PivotFieldSubtotalType.None, true) çağırmak, pivot’tan her alt toplam satırını kaldırarak yalnızca alan satırlarını ve alttaki genel toplamı bırakır. Bu, ham gruplandırılmış verileri herhangi bir özet satır olmadan istediğinizde kullanışlıdır.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

string[] headers = { "Category", "Item", "Year", "Amount" };
for (int j = 0; j < headers.Length; j++)
{
    worksheet.Cells[0, j].PutValue(headers[j]);
}

object[,] data = {
    { "Fruit",     "Apple",  2020, 100 },
    { "Fruit",     "Apple",  2021, 150 },
    { "Fruit",     "Banana", 2020, 80  },
    { "Fruit",     "Banana", 2021, 90  },
    { "Vegetable", "Carrot", 2020, 50  },
    { "Vegetable", "Carrot", 2021, 60  },
    { "Vegetable", "Daikon", 2020, 40  },
    { "Vegetable", "Daikon", 2021, 45  }
};

for (int i = 0; i < data.GetLength(0); i++)
{
    for (int j = 0; j < data.GetLength(1); j++)
    {
        worksheet.Cells[i + 1, j].PutValue(data[i, j]);
    }
}

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.None, true);
pivotTable.CalculateData();

workbook.Save("output_none.xlsx");

Senaryo 3 — Özel Alt Toplam Alt Kümesi (Sum + Average)

Tek bir alt toplam türüyle sınırlı değilsiniz. Her SetSubtotals çağrısı bir tür üzerinde bağımsız olarak çalışır, dolayısıyla yöntemi iki kez çağırmak — bir kez Sum ile ve bir kez Average ile — her Category grubu için iki alt toplam satırından oluşan özel bir alt küme oluşturur.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells["A1"].PutValue("Category");
worksheet.Cells["B1"].PutValue("Item");
worksheet.Cells["C1"].PutValue("Year");
worksheet.Cells["D1"].PutValue("Amount");

worksheet.Cells[1, 0].PutValue("Fruit");
worksheet.Cells[1, 1].PutValue("Apple");
worksheet.Cells[1, 2].PutValue(2020);
worksheet.Cells[1, 3].PutValue(100);

worksheet.Cells[2, 0].PutValue("Fruit");
worksheet.Cells[2, 1].PutValue("Apple");
worksheet.Cells[2, 2].PutValue(2021);
worksheet.Cells[2, 3].PutValue(150);

worksheet.Cells[3, 0].PutValue("Fruit");
worksheet.Cells[3, 1].PutValue("Banana");
worksheet.Cells[3, 2].PutValue(2020);
worksheet.Cells[3, 3].PutValue(80);

worksheet.Cells[4, 0].PutValue("Fruit");
worksheet.Cells[4, 1].PutValue("Banana");
worksheet.Cells[4, 2].PutValue(2021);
worksheet.Cells[4, 3].PutValue(90);

worksheet.Cells[5, 0].PutValue("Vegetable");
worksheet.Cells[5, 1].PutValue("Carrot");
worksheet.Cells[5, 2].PutValue(2020);
worksheet.Cells[5, 3].PutValue(50);

worksheet.Cells[6, 0].PutValue("Vegetable");
worksheet.Cells[6, 1].PutValue("Carrot");
worksheet.Cells[6, 2].PutValue(2021);
worksheet.Cells[6, 3].PutValue(60);

worksheet.Cells[7, 0].PutValue("Vegetable");
worksheet.Cells[7, 1].PutValue("Daikon");
worksheet.Cells[7, 2].PutValue(2020);
worksheet.Cells[7, 3].PutValue(40);

worksheet.Cells[8, 0].PutValue("Vegetable");
worksheet.Cells[8, 1].PutValue("Daikon");
worksheet.Cells[8, 2].PutValue(2021);
worksheet.Cells[8, 3].PutValue(45);

PivotTableCollection pivotTables = worksheet.PivotTables;
int pivotIndex = pivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = pivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.Sum, true);
categoryField.SetSubtotals(PivotFieldSubtotalType.Average, true);

pivotTable.CalculateData();

workbook.Save("output_custom.xlsx");

Özet

Yukarıdaki üç senaryo aynı veri kümesini ve pivot tablo yapısını paylaşır. Aralarındaki tek fark, dış Category satır alanına uygulanan SetSubtotals çağrısıdır. İki alan kuralını unutmayın: bir bölgedeki tek alanın arasında toplanacak bir şey yoktur, dolayısıyla SetSubtotals‘ın görünür bir etkiye sahip olmasını istediğinizde her zaman satır veya sütun bölgesine en az iki alan yerleştirin.

Net: Aspose.Cells for .NET'te PivotTable değer alanlarını yönetme

Mon, 01 Jan 0001 00:00:00 +0000

Veri Bölgesine Alan Ekleme

Veri (değer) bölgesine bir temel alan eklemek, özet tablonun kaynak verilerinizi nasıl toplayacağını şekillendirmenin ilk adımıdır. Aspose.Cells, PivotFieldType.Data sabitini ve kaynak-sütun adını kabul eden PivotTable.AddFieldToArea(PivotFieldType, string) aşırı yüklemesini kullanıma sunar. Bir alan veri bölgesine eklendikten sonra, API bu alanı PivotTable.DataFields koleksiyonu aracılığıyla, alanların eklendiği sırayla sunar. Varsayılan olarak, sayısal bir kaynak sütun ConsolidationFunction.Sum ile özetlenirken, sayısal olmayan bir sütun Count ile özetlenir.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

// A1:D1 aralığında başlıklar
worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

// j değişkenine göre dallanan iç içe döngüler kullanarak A2:D9 veri satırları
for (int i = 1; i <= 8; i++)
{
 for (int j = 0; j < 4; j++)
 {
 switch (j)
 {
 case 0:
 worksheet.Cells[i, j].PutValue(i <= 4 ? "Fruit" : "Vegetable");
 break;
 case 1:
 if (i == 1 || i == 2) worksheet.Cells[i, j].PutValue("Apple");
 else if (i == 3 || i == 4) worksheet.Cells[i, j].PutValue("Banana");
 else if (i == 5 || i == 6) worksheet.Cells[i, j].PutValue("Carrot");
 else worksheet.Cells[i, j].PutValue("Daikon");
 break;
 case 2:
 worksheet.Cells[i, j].PutValue(2020 + ((i - 1) % 2));
 break;
 case 3:
 if (i == 1) worksheet.Cells[i, j].PutValue(100);
 else if (i == 2) worksheet.Cells[i, j].PutValue(150);
 else if (i == 3) worksheet.Cells[i, j].PutValue(80);
 else if (i == 4) worksheet.Cells[i, j].PutValue(90);
 else if (i == 5) worksheet.Cells[i, j].PutValue(50);
 else if (i == 6) worksheet.Cells[i, j].PutValue(60);
 else if (i == 7) worksheet.Cells[i, j].PutValue(40);
 else worksheet.Cells[i, j].PutValue(45);
 break;
 }
 }
}

// F3 hücresine PivotTable1 adında bir pivot tablo ekle
int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// Pivot düzeni: Satırda Category ve Item, Sütunda Year, veri alanı olarak Amount
pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

pivotTable.CalculateData();
workbook.Save("output_drag.xlsx");

Özet Fonksiyonunu Değiştirme

Veri bölgesine yerleştirilen her alan dahili olarak bir PivotField örneği olarak sarılır ve onun Function özelliği ConsolidationFunction enum’undan bir değer döndürür. Aynı Function ayarlayıcısı, Sum, Count, Average, Max, Min, Product, StdDev, StdDevp, Var ve Varp dahil olmak üzere kullanılabilir toplamlar arasında geçiş yapmanızı sağlar.

Function‘ı değiştirmek yalnızca toplamı etkiler, kaynak sütun değişmez.

Bu nedenle, tek bir özet içinde, bir veri alanını Sum olarak bırakırken aynı kaynak sütunu hedefleyen ancak Count veya Average kullanan ikinci bir veri alanı ekleyebilirsiniz.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

for (int i = 1; i <= 8; i++)
{
 for (int j = 0; j <= 3; j++)
 {
 if (j == 0)
 {
 worksheet.Cells[i, j].PutValue(i <= 5 ? "Fruit" : "Vegetable");
 }
 else if (j == 1)
 {
 string[] items = { "Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon" };
 worksheet.Cells[i, j].PutValue(items[i - 1]);
 }
 else if (j == 2)
 {
 int[] years = { 2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021 };
 worksheet.Cells[i, j].PutValue(years[i - 1]);
 }
 else
 {
 int[] amounts = { 100, 150, 80, 90, 50, 60, 40, 45 };
 worksheet.Cells[i, j].PutValue(amounts[i - 1]);
 }
 }
}

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");

pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField countField = pivotTable.DataFields[1];
countField.Function = ConsolidationFunction.Count;

pivotTable.CalculateData();

workbook.Save("output_function.xlsx");

Değer Alanlarını Satır veya Sütun Eksenine Yerleştirme

Bir özet tablo iki veya daha fazla veri alanı içerdiğinde, Aspose.Cells PivotTable.ValuesField adlı ek bir sanal alan sunar. Bu sanal alan, veri bölgesinde bulunan her veri alanının toplamını temsil eder. Onu Satır veya Sütun bölgesine temel bir özet alanı olarak sürükleyebilirsiniz; bu, birden çok ölçümü yan yana düzenlemek için kullanışlıdır.

PivotTable.ValuesField, hiç değer alanı yoksa veya yalnızca bir değer alanı varsa çalışmaz.

Aşağıdaki senaryolar, yukarıda açıklanan her bir yeteneği aynı özet yapısı üzerinde gösteren uçtan uca üç örnek üzerinden ilerler.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

string[] categories = { "Fruit", "Fruit", "Fruit", "Fruit", "Vegetable", "Vegetable", "Vegetable", "Vegetable" };
string[] items = { "Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon" };
int[] years = { 2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021 };
int[] amounts = { 100, 150, 80, 90, 50, 60, 40, 45 };

for (int i = 1; i <= 8; i++)
{
 for (int j = 0; j <= 3; j++)
 {
 if (j == 0) worksheet.Cells[i, j].PutValue(categories[i - 1]);
 else if (j == 1) worksheet.Cells[i, j].PutValue(items[i - 1]);
 else if (j == 2) worksheet.Cells[i, j].PutValue(years[i - 1]);
 else worksheet.Cells[i, j].PutValue(amounts[i - 1]);
 }
}

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Category");
pivotTable.AddFieldToArea(PivotFieldType.Row, "Item");
pivotTable.AddFieldToArea(PivotFieldType.Column, "Year");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

pivotTable.DataFields[1].Function = ConsolidationFunction.Count;

pivotTable.AddFieldToArea(PivotFieldType.Column, pivotTable.ValuesField.Name);

pivotTable.CalculateData();
workbook.Save("output_plot.xlsx");

Net: Aspose.Cells for .NET'te PivotTable'a filtre alanları ekleme

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, pivot tablolardaki filtre alanlarının tüm yaşam döngüsünü destekler. Üst düzey bir kolaylık API’si veya alt düzey PageFields koleksiyonu aracılığıyla bir filtre alanı ekleyebilir, filtreni tek seçim modunda yönlendirebilir, her sayfa öğesini göstermek için temizleyebilir veya alanı Excel’deki onay kutusu kullanıcı arayüzü aracılığıyla kullanıcıların aynı anda birkaç sayfa öğesi seçmesine olanak tanıyan çoklu seçime geçirebilirsiniz.

Giriş

Bir filtre alanı, pivot gövdesinin kaynak verilerin hangi alt kümesini görüntüleyeceğini kontrol eden bir pivot alanıdır. Son kullanıcılar bunu Excel’de oluşturulan pivot’un üst kısmında bir açılır menü olarak görür ve kullanılabilir sayfa öğelerinden birini seçmek, pivot gövdesini yalnızca o sayfa öğesine ait kayıtların özetleneceği şekilde yeniden oluşturur. Bir pivot alanı, PivotFieldType.Row, PivotFieldType.Column veya PivotFieldType.Data yerine PivotFieldType.Page olarak kaydedildiğinde filtre alanı olur.

Bir filtre alanı iki davranışla çalışabilir. Varsayılan tek seçim davranışında aynı anda yalnızca bir sayfa öğesi görünür, böylece pivot gövdesi tam olarak bir alt kümeyi özetler. Çoklu seçim davranışında ise alan bir onay kutusu listesi sunar ve pivot gövdesi işaretlenen her sayfa öğesinin birleşimini özetler. Aynı kaynak alan, tek bir özelliği değiştirerek bu davranışlar arasında ileri geri taşınabilir.

Aspose.Cells for .NET, bir filtre alanı kaydetmek için iki eşdeğer yol sunar. Üst düzey API, kaynak sütun adını alan ve alanı tek bir çağrıyla ekleyen PivotTable.AddFieldToArea(PivotFieldType.Page, "fieldName") yöntemidir. Alt düzey API ise zaten bir PivotField referansına sahip olduğunuzda ve aynı alan örneğini filtre alanına eklemek istediğinizde kullanılan PivotTable.PageFields.Add(PivotField) yöntemidir. Her iki API de aynı PageFields koleksiyonunu doldurur ve bu makalenin geri kalanı aralarında nasıl seçim yapılacağını ve her filtreleme modunun nasıl yönlendirileceğini gösterir.

filtre alanı Ekleme

filtre alanına bir pivot alanı kaydetmenin iki yolu vardır. Üst düzey çağrı, kaynak sütun adını bir dize olarak alır ve en yaygın yoldur. Alt düzey çağrı, mevcut bir PivotField örneğini kabul eder ve aynı alan nesnesinin birden çok pivot alanında yeniden kullanılması gerektiğinde kullanışlıdır. Her iki çağrı da alanı PivotTable.PageFields içine yerleştirir; bundan sonra oluşturulan pivot’un üst kısmında sayfa açılır menüsü olarak görünür.

AddFieldToArea ile filtre alanı Ekleme

Aşağıdaki örnek, küçük bir Fruit / Year / Amount veri kümesi oluşturur, E3 hücresine bir pivot tablo yerleştirir; satır alanında Fruit, veri alanında Amount ve filtre alanında Year bulunur, pivot’u yeniler ve çalışma kitabını kaydeder.

using System;
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Yeni bir çalışma kitabı oluştur
var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

// Başlık satırını ayarla
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 9 satır örnek veri doldur: Meyve, Yıl, Miktar
object[,] data = new object[,]
{
    { "apple", 2020, 100 },
    { "banana", 2021, 200 },
    { "apple", 2021, 150 },
    { "grape", 2020, 120 },
    { "orange", 2022, 180 },
    { "banana", 2020, 90 },
    { "grape", 2021, 130 },
    { "apple", 2022, 170 },
    { "orange", 2021, 110 }
};

for (int i = 0; i < data.GetLength(0); i++)
{
    worksheet.Cells[i + 1, 0].PutValue(data[i, 0]);
    worksheet.Cells[i + 1, 1].PutValue(data[i, 1]);
    worksheet.Cells[i + 1, 2].PutValue(data[i, 2]);
}

// E3 hücresine bağlı bir özet tablo ekle
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

// Alanları kendi alanlarına ekle: Meyve Satır olarak, Miktar Veri olarak, Yıl Sayfa alanı olarak
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

// Özet tablo verilerini yenile ve hesapla
pivotTable.CalculateData();

// Çalışma kitabını kaydet
workbook.Save("pageFieldSample.xlsx");

PageFields.Add ile filtre alanı Ekleme

Zaten bir PivotField örneğiyle çalışırken, onu doğrudan PivotTable.PageFields.Add yöntemine geçirebilirsiniz. Pivot tablo ve filtre alanı, önceki senaryoda olduğu gibi tam olarak oluşturulur; yalnızca son filtre alanı kaydı alt düzey API çağrısıyla değiştirilir.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// — Pivot tablosu ve sayfa alanı tam olarak Senaryo 1a'daki gibi oluşturulur
//   (Meyve/Yıl/Tutar verileri, pivot E3'te, Meyve→Satır, Tutar→Veri).
//   Aşağıda Yıl PivotField'ını BaseFields koleksiyonundan alıp
//   PageFields.Add'a geçiriyoruz — AddFieldToArea'nın düşük seviyeli
//   alternatifidir. Sonuç, Senaryo 1a ile işlevsel olarak aynıdır.

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

// Başlıklar
sheet.Cells["A1"].PutValue("Fruit");
sheet.Cells["B1"].PutValue("Year");
sheet.Cells["C1"].PutValue("Amount");

// Örnek veri (9 satır)
sheet.Cells["A2"].PutValue("apple");    sheet.Cells["B2"].PutValue("2020"); sheet.Cells["C2"].PutValue(100);
sheet.Cells["A3"].PutValue("apple");    sheet.Cells["B3"].PutValue("2021"); sheet.Cells["C3"].PutValue(150);
sheet.Cells["A4"].PutValue("apple");    sheet.Cells["B4"].PutValue("2022"); sheet.Cells["C4"].PutValue(200);
sheet.Cells["A5"].PutValue("grape");    sheet.Cells["B5"].PutValue("2020"); sheet.Cells["C5"].PutValue(300);
sheet.Cells["A6"].PutValue("grape");    sheet.Cells["B6"].PutValue("2021"); sheet.Cells["C6"].PutValue(400);
sheet.Cells["A7"].PutValue("grape");    sheet.Cells["B7"].PutValue("2022"); sheet.Cells["C7"].PutValue(500);
sheet.Cells["A8"].PutValue("blueberry"); sheet.Cells["B8"].PutValue("2020"); sheet.Cells["C8"].PutValue(250);
sheet.Cells["A9"].PutValue("blueberry"); sheet.Cells["B9"].PutValue("2021"); sheet.Cells["C9"].PutValue(350);
sheet.Cells["A10"].PutValue("blueberry");sheet.Cells["B10"].PutValue("2022"); sheet.Cells["C10"].PutValue(450);

// A1:C10 aralığını kapsayacak şekilde E3'e pivot tablo ekle
int pivotIndex = sheet.PivotTables.Add("E3", "A1:C10", "PivotTable1");
PivotTable pivotTable = sheet.PivotTables[pivotIndex];

// Meyve -> Satır, Tutar -> Veri (Yıl aşağıda Sayfa'ya gidecek)
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// Düşük seviyeli yaklaşım: mevcut Yıl PivotField'ını BaseFields'dan alın
// ve PageFields.Add(PivotField) aracılığıyla Sayfa alanına kaydedin.
PivotField yearField = pivotTable.BaseFields["Year"];
pivotTable.PageFields.Add(yearField);

// Yeni sayfa alanının kaydedilen çalışma kitabına yansıtılması için yenileyin
pivotTable.CalculateData();

workbook.Save("output.xlsx");

Tek Seçim Filtreleme (Bir Sayfa Öğesi Gösterme)

Varsayılan tek seçim davranışında filtre alanı tek bir açılır menü olarak işlenir ve PivotField.CurrentPageItem tamsayısı, hangi sayfa öğesinin pivot gövdesini yönlendireceğini seçer. Belirli bir dizin atamak o öğeyi seçer; özel bekçi değeri olan 0x7FFD (ondalık 32765) atamak filtreyi temizler, böylece her sayfa öğesi aynı anda özetlenir. Tek seçim varsayılandır; açıkça etkinleştirmeniz gerekmez.

Tüm Öğeleri Gösterme

CurrentPageItem değerini sihirli değer olan 0x7FFD olarak ayarlamak, filtreni temizlemeye eşdeğerdir: pivot gövdesi, hiçbir filtre uygulanmamış gibi her sayfa öğesini özetler.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

class Program
{
    static void Main()
    {
        // Yeni bir çalışma kitabı oluştur
        Workbook workbook = new Workbook();
        Worksheet sheet = workbook.Worksheets[0];

        // Fruit/Year/Amount verilerini doldur
        sheet.Cells["A1"].PutValue("Fruit");
        sheet.Cells["B1"].PutValue("Year");
        sheet.Cells["C1"].PutValue("Amount");

        object[,] data = new object[,]
        {
            {"Apple", 2022, 100},
            {"Apple", 2023, 150},
            {"Banana", 2022, 80},
            {"Banana", 2023, 120},
            {"Cherry", 2022, 200},
            {"Cherry", 2023, 250}
        };

        for (int r = 0; r < data.GetLength(0); r++)
        {
            for (int c = 0; c < data.GetLength(1); c++)
            {
                sheet.Cells[r + 1, c].PutValue(data[r, c]);
            }
        }

        // E3 konumunda pivot tablo oluştur
        var pivotTables = sheet.PivotTables;
        int index = pivotTables.Add("=A1:C7", "E3", "PivotTable1");
        PivotTable pivotTable = pivotTables[index];

        // Pivot alanlarını yapılandır: Fruit→Satır, Amount→Veri, Year→Sayfa
        pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
        pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
        pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

        pivotTable.CalculateData();

        // Sayfa filtresini temizle, böylece sayfa alanındaki her öğe görünür olsun.
        // 0x7FFD (ondalık 32765), "tüm öğeler" anlamına gelen özel sentinel değeridir —
        // Excel'in sayfa alanı açılır menüsünde "(Tümü)" seçmeye eşdeğerdir.
        pivotTable.PageFields[0].CurrentPageItem = 0x7FFD;

        workbook.Save("output.xlsx");
    }
}

Belirli Bir Öğeyi Gösterme

CurrentPageItem değerini gerçek bir dizine ayarlamak yalnızca o sayfa öğesini seçer. Dizin, filtre alanının sıralanmış öğe listesindeki öğenin konumudur; örneğin 1 sıralamadan sonra ikinci öğeyi seçer.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// Çalışma kitabı oluştur
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
var cells = sheet.Cells;

// Örnek veri ekle (Meyve/Yıl/Tutar)
cells["A1"].PutValue("Fruit");
cells["B1"].PutValue("Year");
cells["C1"].PutValue("Amount");

cells["A2"].PutValue("Apple");
cells["B2"].PutValue("2020");
cells["C2"].PutValue("100");

cells["A3"].PutValue("Apple");
cells["B3"].PutValue("2021");
cells["C3"].PutValue("150");

cells["A4"].PutValue("Banana");
cells["B4"].PutValue("2020");
cells["C4"].PutValue("200");

cells["A5"].PutValue("Banana");
cells["B5"].PutValue("2021");
cells["C5"].PutValue("250");

// E3'e pivot tablo ekle
var pivotTables = sheet.PivotTables;
int pivotIndex = pivotTables.Add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables[pivotIndex];

// Alanları ekle: Meyve→Satır, Tutar→Veri, Yıl→Sayfa
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

// Sayfa alanına özel işlemler
pivotTable.PageFields[0].CurrentPageItem = 1; // 1 = sıralı düzende ikinci öğe (ör. "2021")

// Pivot tabloyu yenile ve hesapla
pivotTable.CalculateData();

workbook.Save("output.xlsx");

Çoklu Seçim Filtreleme

Çoklu seçim filtreleme, sayfa açılır menüsünü bir onay kutusu listesine dönüştürür ve son kullanıcının aynı anda birkaç sayfa öğesi seçmesine olanak tanır. Aspose.Cells, birlikte çalışan iki özellik sunar. PivotField.IsMultipleItemSelectionAllowed değeri, çoklu seçim kullanıcı arayüzünün etkili olmasından önce true olarak ayarlanmalıdır. Etkinleştirildikten sonra, PivotItem.IsHidden onay kutusu listesinde hangi öğelerin görüneceğini kontrol eder; böylece her öğeyi gösterebilir veya yalnızca belirli öğeleri beyaz listeye alabilirsiniz.

Aşağıdaki kod, Senaryo 1a’da oluşturulan aynı Year filtre alanında çoklu seçimi etkinleştirir ve ardından iki kalıp gösterir: Bölüm A, her giriş için IsHidden değerini false bırakarak her sayfa öğesini ortaya çıkarırken, Bölüm B yalnızca seçtiğiniz kaynak değerleri beyaz listeye alır ve diğer her şeyi switch (pivotItems[i].GetStringValue()) bloğu aracılığıyla gizler.

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// — Pivot tablosu ve sayfa alanı tam olarak şu şekilde oluşturulur
//   Senaryo 1a'da olduğu gibi (Fruit/Year/Amount verileri, E3'te pivot, Fruit→Satır,
//   Amount→Veri, Year→Sayfa AddFieldToArea aracılığıyla).
//   Aşağıda sayfa alanına çoklu seçim filtreleme uyguluyoruz.

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;

// Örnek veri: Fruit | Year | Amount
cells[0, 0].PutValue("Fruit");
cells[0, 1].PutValue("Year");
cells[0, 2].PutValue("Amount");

string[,] data = new string[,]
{
    { "apple",  "2019", "100" },
    { "apple",  "2020", "150" },
    { "apple",  "2021", "200" },
    { "banana", "2019", "110" },
    { "banana", "2020", "160" },
    { "banana", "2021", "210" },
    { "grape",  "2019", "120" },
    { "grape",  "2020", "170" },
    { "grape",  "2021", "220" }
};

for (int i = 0; i < data.GetLength(0); i++)
{
    cells[i + 1, 0].PutValue(data[i, 0]);
    cells[i + 1, 1].PutValue(Convert.ToInt32(data[i, 1]));
    cells[i + 1, 2].PutValue(Convert.ToInt32(data[i, 2]));
}

Worksheet pivotSheet = workbook.Worksheets.Add("Pivot");
PivotTableCollection pivots = pivotSheet.PivotTables;
int pivotIndex = pivots.Add("A1:C10", "E3", "PivotTable1");
PivotTable pivotTable = pivots[pivotIndex];

pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

// — Sayfa alanında çoklu seçimi etkinleştir
pivotTable.PageFields[0].IsMultipleItemSelectionAllowed = true;

// Bölüm A — TÜM öğeleri seç (her öğeyi görünür yap)
PivotItemCollection pivotItems = pivotTable.PageFields[0].PivotItems;
for (int i = 0; i < pivotItems.Count; i++)
{
    pivotItems[i].IsHidden = false;
}

// Bölüm B — yalnızca kaynak değere göre belirli öğeleri seç
for (int i = 0; i < pivotItems.Count; i++)
{
    switch (pivotItems[i].GetStringValue())
    {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems[i].IsHidden = false;
            break;
        default:
            pivotItems[i].IsHidden = true;
            break;
    }
}

pivotTable.CalculateData();

workbook.Save("output.xlsx");

Not: PivotItem.IsHidden aracılığıyla çoklu seçim filtreleme kullanırken, en az bir PivotItem görünür kalmalıdır (IsHidden == false). Her öğe gizlenmişse, Excel dosyayı açarken ya çöker ya da boş bir pivot oluşturur. Çoklu seçim beyaz listenizin kaynak verilerinizden en az bir öğe içerdiğini her zaman doğrulayın.

Hangi API’yi ve Hangi Modu Kullanmalıyım?

Aşağıdaki tablo, her senaryoyu ayrıntılı olarak okumadan doğru kombinasyonu seçebilmeniz için her API’nin ve modun ne zaman kullanılacağını özetler.

Senaryo / Kullanım Durumu	Önerilen API	Kullanılan Özellik	Notlar
Kaynak sütun adına göre filtre alanı ekleme (en yaygın)	`PivotTable.AddFieldToArea(PivotFieldType.Page, "fieldName")`	n/a	Üst düzey, tek satır. Bir `PivotField` referansına ihtiyacınız yoksa bunu kullanın.
Zaten bir `PivotField` nesneniz olduğunda filtre alanı ekleme	`PivotTable.PageFields.Add(PivotField)`	n/a	Alan nesnesi başka bir yerden alındığında veya yeniden kullanılması gerektiğinde kullanın.
Tek bir sayfa öğesine filtreleme (varsayılan mod)	`PivotField.CurrentPageItem`	belirli bir dizine ayarla	Örneğin, `1` sıralanmış listedeki ikinci öğeyi gösterir.
Tüm öğeleri gösterme / filtreni temizleme	`PivotField.CurrentPageItem`	`0x7FFD` olarak ayarla	Sihirli değer `0x7FFD` (ondalık 32765), “tüm öğeler” için bekçi değeridir.
Excel’de çoklu seçim kullanıcı arayüzünü etkinleştirme	`PivotField.IsMultipleItemSelectionAllowed`	`true` olarak ayarla	Herhangi bir `IsHidden` çağrısının etkili olmasından önce gereklidir.
Çoklu seçim listesinde tek tek öğeleri gizleme / gösterme	`PivotItem.IsHidden`	öğe bazında ayarla	En az bir öğe görünür kalmalıdır (`IsHidden == false`).

Çoklu seçim filtrelemeyi yapılandırırken görünürlük kısıtlamasını her zaman hatırlayın. Çoklu seçim filtre alanındaki her PivotItem gizlenmişse, Excel açılırken çöker veya boş bir pivot oluşturur. Beyaz listenizi kaynak verilerinize göre oluşturun, böylece en az bir öğe görünür kalır ve kaydedilen çalışma kitaplarınız her makinede güvenilir şekilde açılır.

Net: Bir Çalışma Sayfasından Pivot Tablosunu Sil

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, bir Çalışma Sayfasından Pivot Tablosunu silme veya kaldırma özelliği sağlar. Pivot tablosu nesnesini veya pivot tablosu pozisyonunu kullanarak pivot tablosunu silebilirsiniz. Pivot tablosunu nesnesini kullanarak pivot tablosunu silmek için lütfen Worksheet.PivotTables.Remove() yöntemini ve pivot tablosu koleksiyonundaki pozisyonunu kullanarak pivot tablosunu silme yöntemi Worksheet.PivotTables.RemoveAt() kullanın.

Aşağıdaki örnek kod, çalışma sayfasından iki pivot tablosunu siler. İlk önce Worksheet.PivotTables.Remove() yöntemini kullanarak pivot tablosunu kaldırır, ardından Worksheet.PivotTables.RemoveAt() yöntemini kullanarak pivot tablosunu kaldırır.

Net: Özet Tabloyu ODS Dosyasına Kaydetme

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells, pivot tablosunu ODS dosyalarına kaydetme özelliği sağlar. Bunun için mevcut bir pivot tablosu içeren bir çalışma kitabını dönüştürmeniz veya yeni bir pivot tablosu oluşturmanız ve dosyayı ODS formatında kaydetmeniz yeterlidir. Çıktıda pivot tablosunun ODS dosyasında render edildiğinden emin olmak için kaydetmeden önce PivotTable.CalculateData() metodunu çağırmanız gerekmektedir. Aşağıdaki kod örneği, pivot tablosunu ODS dosyasına kaydetmeyi göstermektedir.

Örnek Kod

Yukarıdaki kod tarafından oluşturulan çıkış dosyası referans için ekte bulunmaktadır.

Çıktı ODS Dosyası

Documentation – Pivot Tablo Ekle

Net: Pivot Tablosunu Biçimlendirme

Döndürme Tablosu Görünümü

Döndürme Tablosu Biçim Seçeneklerini Ayarlama

Microsoft Excel, birkaç farklı önceden ayarlanmış rapor formatı sunar. Aspose.Cells, bu formatlama seçeneklerini de destekler. Bunlara erişmek için:

Biçim Seçeneklerini Ayarlama

Aşağıdaki kod örneği, pivot tablosunu satır ve sütunlar için toplamları göstermek üzere biçimlendirme ve raporun alan sırasını ayarlamayı gösterir. Ayrıca, null değerler için özel bir dize ayarlamak da gösterilir.

Pivot Tablo Raporunun nasıl göründüğü ile ilgili nasıl biçimlendirileceğiniz, önceden ayarlanmış rapor formatlarını değil, {0} ve {1} yöntemlerini kullanarak el ile ayarlamak için kullanılır. İstenen biçimlendirme için bir stil nesnesi oluşturun, örneğin:

Satır/Sütun/Sayfa Alanları Biçimi Ayarlama

Veri alanları biçimini ayarlama

Pivot Alanlarını Temizleme

Net: Özet Tabloları ve Özet Grafikler Oluşturma

Özet Tabloları ve Grafikler Eklemek

Aspose.Cells’i kullanmaya hazırlık

Pivot Tablo Ekleme

Pivot Grafik Ekleme

Net: Pivot Tablosu ve Kaynak Veri

Pivot Tablosunun Kaynak Verisi

Bir Pivot Tablosunun Veri Kaynağını Değiştirme

Net: Pivot Tablosunda Hesaplanmış Alan Ekleme

Olası Kullanım Senaryoları

Excel’de Pivot Tablosunda Hesaplanmış Alan Ekleme

C# Kullanarak Pivot Tablosunda Hesaplanmış Alan Ekleme

Örnek Kod

Net: Aspose.Cells for .NET'te PivotTable'lara stil uygulama

Giriş

Eski Bir XLS Ön Ayar Otomatik Biçimi Uygulama

Modern Adlandırılmış Ön Ayar Özet Tablo Stili Uygulama

Özel Bir Özet Tablo Stili Tanımlama ve Uygulama

FormatAll ile Her Pivot Hücresine Tek Bir Stil Uygulama

Hangi Stil API’sini Kullanmalıyım?

Net: Aspose.Cells for .NET'te PivotTable'ları ve PivotTable önbelleklerini yenileme

Giriş

Gerekli Using Direktifleri

Çalışma Kitabındaki Tüm Özet Tablolarını Yenileme

Tek Bir Çalışma Sayfasındaki Tüm Özet Tablolarını Yenileme

Tek Bir Özet Tablosunu Yenileme

Kaynak Veriler Değişti — PivotCache.Refresh() Kullanın

Yalnızca Görünüm/Düzen Değişti — CalculateData() Kullanın

Aynı PivotCache’i Paylaşan Tüm Özet Tablolarını Alma

Kullanımdan Kaldırılan PivotTable.RefreshData()‘dan Geçiş

Hangi Yenileme API’sini Kullanmalıyım?

Net: Aspose.Cells for .NET'te PivotTable'a satır ve sütun alanları ekleme

Satır veya Sütun Bölgesine Alan Ekleme

Pivot Alanı Alt Toplamları

Senaryo 1 — Otomatik (Varsayılan) Alt Toplamlar

Senaryo 2 — Tüm Alt Toplamları Gizleme (None)

Senaryo 3 — Özel Alt Toplam Alt Kümesi (Sum + Average)

Özet

Net: Aspose.Cells for .NET'te PivotTable değer alanlarını yönetme

Veri Bölgesine Alan Ekleme

Özet Fonksiyonunu Değiştirme

Değer Alanlarını Satır veya Sütun Eksenine Yerleştirme

Net: Aspose.Cells for .NET'te PivotTable'a filtre alanları ekleme

Giriş

filtre alanı Ekleme

AddFieldToArea ile filtre alanı Ekleme

PageFields.Add ile filtre alanı Ekleme

Tek Seçim Filtreleme (Bir Sayfa Öğesi Gösterme)

Tüm Öğeleri Gösterme

Belirli Bir Öğeyi Gösterme

Çoklu Seçim Filtreleme

Hangi API’yi ve Hangi Modu Kullanmalıyım?

Net: Bir Çalışma Sayfasından Pivot Tablosunu Sil

Net: Özet Tabloyu ODS Dosyasına Kaydetme

Örnek Kod

Kaynak Veriler Değişti — `PivotCache.Refresh()` Kullanın

Yalnızca Görünüm/Düzen Değişti — `CalculateData()` Kullanın

Kullanımdan Kaldırılan `PivotTable.RefreshData()`‘dan Geçiş