Yüzlerce satır içeren büyük Excel belgeleriyle çalışırken, başlık satırınızı veri üzerinden kaydırırken görünür tutmanın bir zorluğu olabilir. VB.NET Excel üzerinde tepe satırı dondurma işlevi bu sorunu çözer, belirli satırları ve sütunları yerinde kilitleyerek. Bu makale, kullanıcıların hesap tablosu verilerini hızla ve kolayca gezmelerine yardımcı olarak, .NET uygulamalarınızda IronXL kullanarak dondurma panelleri oluşturmayı programatik olarak nasıl yapacağınızı gösterir.

IronXL, Excel dosyalarını Microsoft Office'in sunucuda yüklü olmasına gerek kalmadan okuyup, yazabilir ve manipüle edebilirsiniz. CreateFreezePane yöntemi, uygulamanızın ürettiği veya değiştirdiği herhangi bir Excel dosyasında satırları ve sütunları kilitlemek için WorkSheet nesnesi üzerinde ihtiyacınız olan her şeydir.

Ücretsiz deneme sürümünü başlatın ve aşağıdaki kod örneklerini takip edin.

.NET Projeniz İçin IronXL Nasıl Kurulur?

Herhangi bir dondurma paneli kodu yazmadan önce, IronXL'i projenize NuGet Paket Yöneticisi'ni kullanarak ekleyin. Terminalinizi açın ve aşağıdaki komutu çalıştırın:

dotnet add package IronXL.Excel

Alternatif olarak, Visual Studio Paket Yöneticisi Konsolunu kullanın:

Install-Package IronXL.Excel

Yüklemeden sonra, dosyanızın en üstüne IronXL ad alanını ekleyin. IronXL, .NET 10'u hedefler ve tüm büyük platformları destekler - Windows, Linux ve macOS - bu nedenle dondurulmuş panel mantığınız dağıttığınız yere bakılmaksızın aynı şekilde çalışır.

Kurulduktan sonra, mevcut çalışma kitaplarını yükleyebilir veya sadece birkaç satırda yenilerini oluşturabilirsiniz. Kütüphane, hem .xlsx (Excel 2007 ve sonrası) hem de .xls (Excel 97-2003) formatları ile çalışır, ancak dondurulmuş panel desteği modern .xlsx formatını gerektirir. Aşağıdaki tablo, bu kılavuzda ele alınan ana WorkSheet yöntemlerini özetler.

Excel Dosyasında Satırları Nasıl Dondurursunuz?

Cevap basittir: çalışma sayfanız nesnesi üzerinde CreateFreezePane yöntemini kullanın. Bu yöntem, Excel sayfasının geri kalanı serbestçe kayarken hangi satır ve sütunların görünür kalacağını kontrol eden parametreler kabul eder. İlk satırı dondurduğunuzda, başlık, veriler üzerinden ne kadar gezinmiş olursanız olun üstte kilitli kalır, Excel'in yerel Pencereleri Dondurma özelliğine benzer.

Aşağıdaki kod parçası, mevcut bir Excel belgesinin nasıl yüklendiğini ve üst satırın nasıl dondurulacağını gösterir:

using IronXL;
using System.Linq;

// Load an existing workbook from file
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1);

// Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx");

using IronXL;
using System.Linq;

// Load an existing workbook from file
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1);

// Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx");

Imports IronXL
Imports System.Linq

' Load an existing workbook from file
Dim workBook As WorkBook = WorkBook.Load("financial_report.xlsx")
Dim workSheet As WorkSheet = workBook.WorkSheets.First()

' Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1)

' Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx")

Imports IronXL
Imports System.Linq

' Load an existing workbook from file
Dim workBook As WorkBook = WorkBook.Load("financial_report.xlsx")
Dim workSheet As WorkSheet = workBook.WorkSheets.First()

' Freeze the first row to keep headers visible
workSheet.CreateFreezePane(0, 1)

' Save the Excel file with freeze panes applied
workBook.SaveAs("financial_report_Frozen.xlsx")

Çıktı

CreateFreezePane(0, 1) yöntem çağrısı sıfır sütun ve bir satır dondurur. Bu, üst satırı görünür tutarken tüm sütunların sola ve sağa kaydırılmasına izin verir. Parametreler, kaydırma alanının üzerinde ve solunda hangi satır ve sütunların bulunduğunu ayarlar. Bu basit yaklaşım sayesinde kullanıcılar, büyük belgelerde yerlerini kaybetmeden verilerini başlık etiketlerine göre kontrol edebilirler.

Yöntem, sütunlar için sıfır bazlı, satırlar için bir bazlı sayım kullanır, bu da dahili Excel dosya formatına uyar. Sütun parametresi için 0 geçtiğinizde, hiçbir sütun dondurulmaz - sadece belirttiğiniz satır kilitlenir.

Excel'de İlk Sütun Nasıl Dondurulur?

Satırlar yerine ilk sütunu dondurmak için CreateFreezePane yöntemindeki parametreleri ayarlayın. Bu, Excel hesap tablonuzda, doğru sütunlar arasında gezinirken görünür kalmasını istediğiniz kimlik bilgileri sütunu A olduğunda yardımcı olur.

Aşağıdaki kod parçacığı, nasıl yeni bir çalışma kitabı oluşturulacağını ve ilk sütunun nasıl dondurulacağını gösterir:

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("SalesData");

// Add sample header and data to the range
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Q1 Sales";
workSheet["C1"].Value = "Q2 Sales";
workSheet["D1"].Value = "Q3 Sales";
workSheet["E1"].Value = "Q4 Sales";

// Populate a few rows of sample data
workSheet["A2"].Value = "PROD-001";
workSheet["B2"].Value = 14500;
workSheet["A3"].Value = "PROD-002";
workSheet["B3"].Value = 21300;

// Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0);

// Save as xlsx file
workBook.SaveAs("SalesReport.xlsx");

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("SalesData");

// Add sample header and data to the range
workSheet["A1"].Value = "Product ID";
workSheet["B1"].Value = "Q1 Sales";
workSheet["C1"].Value = "Q2 Sales";
workSheet["D1"].Value = "Q3 Sales";
workSheet["E1"].Value = "Q4 Sales";

// Populate a few rows of sample data
workSheet["A2"].Value = "PROD-001";
workSheet["B2"].Value = 14500;
workSheet["A3"].Value = "PROD-002";
workSheet["B3"].Value = 21300;

// Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0);

// Save as xlsx file
workBook.SaveAs("SalesReport.xlsx");

Imports IronXL

' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("SalesData")

' Add sample header and data to the range
workSheet("A1").Value = "Product ID"
workSheet("B1").Value = "Q1 Sales"
workSheet("C1").Value = "Q2 Sales"
workSheet("D1").Value = "Q3 Sales"
workSheet("E1").Value = "Q4 Sales"

' Populate a few rows of sample data
workSheet("A2").Value = "PROD-001"
workSheet("B2").Value = 14500
workSheet("A3").Value = "PROD-002"
workSheet("B3").Value = 21300

' Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0)

' Save as xlsx file
workBook.SaveAs("SalesReport.xlsx")

Imports IronXL

' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("SalesData")

' Add sample header and data to the range
workSheet("A1").Value = "Product ID"
workSheet("B1").Value = "Q1 Sales"
workSheet("C1").Value = "Q2 Sales"
workSheet("D1").Value = "Q3 Sales"
workSheet("E1").Value = "Q4 Sales"

' Populate a few rows of sample data
workSheet("A2").Value = "PROD-001"
workSheet("B2").Value = 14500
workSheet("A3").Value = "PROD-002"
workSheet("B3").Value = 21300

' Freeze the first column to keep Product IDs visible
workSheet.CreateFreezePane(1, 0)

' Save as xlsx file
workBook.SaveAs("SalesReport.xlsx")

Çıktı

Burada, CreateFreezePane(1, 0) bir sütun ve sıfır satır dondurur. Kullanıcılar, ek hücre verilerini okumak için yatay olarak kaydırırken ilk sütun sayfanın sol tarafında kilitli kalır. Bu, özellikle üç aylık dökümler veya öznitelik sütunları arasında gezindiğinizde ürün kodlarının görünür kalması gereken finansal raporlar veya envanter listeleri için yararlıdır.

Bu deseni birden fazla sütunu dondurmak için genişletebilirsiniz. Örneğin, ilk argüman olarak 2 geçirmek, kullanıcıların geniş tabloları gezinirken daha geniş bir çapa sağlaması için iki en soldaki sütunu yerinde kilitler. Bu teknik, veri karşılaştırmaları sunmak gerektiğinde hücre aralığı seçimi ile iyi çalışır.

Nasıl Hem Satırları Hem de Sütunları Birlikte Dondurursunuz?

Karmaşık Excel belgelerini işleyen uygulamalar için, hem üst satırı hem de ilk sütunu aynı anda kilitleyen dondurma panelleri oluşturmanız gerekebilir. Bu, kaydırma yönünüz hangisi olursa olsun, başlık etiketlerinizi ve satır kimliklerinizi görünür tutar, hücre verilerinizi anlamanızı ve filtrelemenizi kolaylaştırır.

using IronXL;

// Load workbook or create a new one
WorkBook workBook = WorkBook.Load("Inventory.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1);

// Save the document
workBook.SaveAs("Inventory_Frozen.xlsx");

using IronXL;

// Load workbook or create a new one
WorkBook workBook = WorkBook.Load("Inventory.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1);

// Save the document
workBook.SaveAs("Inventory_Frozen.xlsx");

Imports IronXL

' Load workbook or create a new one
Dim workBook As WorkBook = WorkBook.Load("Inventory.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1)

' Save the document
workBook.SaveAs("Inventory_Frozen.xlsx")

Imports IronXL

' Load workbook or create a new one
Dim workBook As WorkBook = WorkBook.Load("Inventory.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Freeze first row AND first column simultaneously
workSheet.CreateFreezePane(1, 1)

' Save the document
workBook.SaveAs("Inventory_Frozen.xlsx")

Çıktı

CreateFreezePane(1, 1) çağrısı, dondurulmuş panelleri bir sütun ve bir satır kilitleyecek şekilde ayarlar. Bu dosyayı Excel'de açtığınızda, herhangi bir yönde kaydırma, başlık satırını ve kimlik sütununu sayfada görünür tutar. Bu, birçok satır ve sütun boyunca tablo verilerini gösteren raporlama uygulamaları geliştirirken geliştiricilerin sıkça karşılaştığı bir soruyu yanıtlar.

Bu yapılandırma, hem dikey hem de yatay gezinmenin rutin olduğu envanter yönetimi, İK raporları ve finansal panellerde yaygındır. hücre biçimlendirme ile -- kalın başlıklar, arka plan renkleri -- kombine edebilirsiniz böylece donmuş alan kaydırılan bölgeden görsel olarak öne çıkar.

Neden İleri Düzey Dondurma Panelleri Yöntemi ile Ön Kayıt Kullanılır?

IronXL, dört parametre kullanan ileri düzey bir seçenek sunarak, önceden kaydırılmış bir başlangıç pozisyonu ile dondurma panelleri eklemenizi sağlar. Bu, neyin dondurulacağını değil, kullanıcılar dosyayı ilk açtığında kaydırma alanının nerede başlayacağını da kontrol eder.

Gösterge panoları veya ayda aşkın belirli bir veri bölümüne inmek için ilk görünümü bu ayın verilerini hemen gösterirken, başlık satırı ve kimlik sütunu donmuş halde görünmesini sağlamak için dashboardlar veya yönetim raporları için kullanışlıdır.

using IronXL;
using System.Linq;

WorkBook workBook = WorkBook.Load("LargeDataset.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze columns A-B and rows 1-3
// Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7);

workBook.SaveAs("LargeDataset_Configured.xlsx");

using IronXL;
using System.Linq;

WorkBook workBook = WorkBook.Load("LargeDataset.xlsx");
WorkSheet workSheet = workBook.WorkSheets.First();

// Freeze columns A-B and rows 1-3
// Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7);

workBook.SaveAs("LargeDataset_Configured.xlsx");

Imports IronXL
Imports System.Linq

Dim workBook As WorkBook = WorkBook.Load("LargeDataset.xlsx")
Dim workSheet As WorkSheet = workBook.WorkSheets.First()

' Freeze columns A-B and rows 1-3
' Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7)

workBook.SaveAs("LargeDataset_Configured.xlsx")

Imports IronXL
Imports System.Linq

Dim workBook As WorkBook = WorkBook.Load("LargeDataset.xlsx")
Dim workSheet As WorkSheet = workBook.WorkSheets.First()

' Freeze columns A-B and rows 1-3
' Pre-scroll so the scrolling pane starts at row 8
workSheet.CreateFreezePane(2, 3, 2, 7)

workBook.SaveAs("LargeDataset_Configured.xlsx")

Çıktı

Ek parametreler, bölünmüş görünümün nerede başladığını kontrol eder. Bu örnekte, çalışma kitabı açıldığında, 1-3 satırları üstte donmuş halde kalırken kaydırma bölümü 8. satırdan başlar. Üçüncü parametre (leftmostCol), sağdaki kaydırma panelinin hangi sütundan başlayacağını ayarlar ve dördüncü parametre (topRow) alt kaydırma panelinde görünen ilk satırı ayarlar.

Unutmayın ki her bir çalışma sayfası için yalnızca bir dondurma paneli yapılandırması bulunabilir -- herhangi bir sonraki çağrı, önceki ayarı geçersiz kılar. Donma konfigürasyonunu dinamik olarak değiştirmeniz gerekiyorsa, önce RemovePane() öğesini, ardından yeni parametrelerle CreateFreezePane öğesini çağırın.

Bir Çalışma Sayfasından Dondurma Panelleri Nasıl Kaldırılır?

Eğer dondurulmuş paneller mevcutsa ve bunları kaldırmanız gerekiyorsa, RemovePane yöntemi bunu sorunsuzca yönetir. Bu, farklı bir dondurma yapılandırması yüklemeniz veya sayfayı normal kaydırmaya geri döndürmeniz gerektiğinde faydalı olabilir.

// Remove all existing freeze or split panes
workSheet.RemovePane();

// Remove all existing freeze or split panes
workSheet.RemovePane();

net

net

Bu tek satır, sayfada var olan tüm dondurulmuş bölmeleri temizler ve belgeyi taze bir biçimlendirme oluşturmanıza veya dondurulmuş bölümler olmadan bırakmanıza izin verir. RemovePane öğesini çağırdıktan sonra, yeni parametrelerle hemen CreateFreezePane öğesini tekrar çağırabilirsiniz - iki işlem doğal olarak bir araya gelir.

Dondurulmuş paneller, dosya formatı sınırlamaları nedeniyle Microsoft Excel 97-2003 (.xls) formatıyla çalışmaz. En iyi sonuçlar için belgelerinizi .xlsx dosyaları olarak kaydedin. İndirilen dosyaların dondurulmuş bölmeleri doğru göstermeme sorunu yaşıyorsanız, uyumlu bir Excel sürümü kullandığınızı ve dosyanın modern formatta kaydedildiğini doğrulayın.

Dondurulmuş bölme kaldırmayı diğer sayfa işlemleriyle de birleştirebilirsiniz. Örneğin, farklı bir yerleşime dışa aktarmadan önce, dondurma yapılandırmasını kaldırabilir, yeni satır ve sütunlar ekleyebilir, verileri yeniden yapılandırabilir ve ardından güncellenen yerleşime uyan yeni bir dondurma yapılandırması uygulayabilirsiniz.

Birden Fazla Sayfada Dondurulmuş Bölmeleri Nasıl Uygularsınız?

Birçok Excel çalışma kitabı, her departman, bölge veya zaman dilimi için birer tane olacak şekilde birkaç sayfa içerir. Her sayfaya programatik olarak dondurulmuş bölmeler uygulamak, bunu Excel uygulamasında manuel olarak yapmaktan zaman kazandırır.

Aşağıdaki örnek bir çalışma kitabını yükler, tüm sayfa üzerinden iterasyon yapar ve her birine aynı dondurma yapılandırmasını uygular:

using IronXL;

WorkBook workBook = WorkBook.Load("MultiSheetReport.xlsx");

// Apply freeze panes to every worksheet in the workbook
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    // Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1);
}

workBook.SaveAs("MultiSheetReport_Frozen.xlsx");

using IronXL;

WorkBook workBook = WorkBook.Load("MultiSheetReport.xlsx");

// Apply freeze panes to every worksheet in the workbook
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    // Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1);
}

workBook.SaveAs("MultiSheetReport_Frozen.xlsx");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("MultiSheetReport.xlsx")

' Apply freeze panes to every worksheet in the workbook
For Each sheet As WorkSheet In workBook.WorkSheets
    ' Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1)
Next

workBook.SaveAs("MultiSheetReport_Frozen.xlsx")

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("MultiSheetReport.xlsx")

' Apply freeze panes to every worksheet in the workbook
For Each sheet As WorkSheet In workBook.WorkSheets
    ' Freeze top row and first column on each sheet
    sheet.CreateFreezePane(1, 1)
Next

workBook.SaveAs("MultiSheetReport_Frozen.xlsx")

Bu desen, her bir sayfanın bir ayı temsil ettiği üç aylık mali paketler için veya her bölgenin kendi sekmesine sahip olduğu çok bölgelik satış raporları için özellikle pratiktir. Excel aralık verilerini sıralama ve koşullu biçimlendirme uygulama ile birleştirildiğinde, tamamen biçimlendirilmiş, paylaşmaya hazır çalışma kitaplarını tamamen koddan oluşturabilirsiniz.

IronXL ayrıca daha derin bir çalışma kitabı incelemesi için Çalışma Kitabı nesne modeline erişmenizi sağlar. Sayfa sayısını kontrol edebilir, sayfaları ada veya indeks ile alabilir ve içerik türlerine göre farklı sayfalara farklı dondurma yapılandırmaları uygulayabilirsiniz. Örneğin, bir özet sayfası yalnızca üst sırayı dondurabilirken, detay sayfaları hem bir satır hem de bir sütunu dondurabilir.

Dondurulmuş Bölme Ayarlarını Kaydetmeden Önce Nasıl Doğrularsınız?

Üretim kodunda, dosyayı diske yazmadan önce dondurulmuş bölme yapılandırmasını doğrulamak iyi bir uygulamadır. IronXL şu anda dondurulmuş bölme durumu için doğrudan bir geri okuma API'si sunmadığından, önerilen yaklaşım, yapılandırmayı kendi kodunuzda izlemek ve kaydetme işleminin hatasız tamamlandığını doğrulamak yönündedir.

Herhangi bir .NET 10 projesinde uygulayabileceğiniz savunmacı bir kodlama deseni şudur:

using IronXL;
using System;

try
{
    WorkBook workBook = WorkBook.Load("source.xlsx");
    WorkSheet workSheet = workBook.DefaultWorkSheet;

    int freezeCol = 1;
    int freezeRow = 1;

    if (freezeCol >= 0 && freezeRow >= 0)
    {
        workSheet.CreateFreezePane(freezeCol, freezeRow);
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).");
    }
    else
    {
        Console.WriteLine("Invalid freeze pane parameters -- skipping.");
    }

    workBook.SaveAs("output.xlsx");
    Console.WriteLine("Workbook saved successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Error applying freeze pane: {ex.Message}");
}

using IronXL;
using System;

try
{
    WorkBook workBook = WorkBook.Load("source.xlsx");
    WorkSheet workSheet = workBook.DefaultWorkSheet;

    int freezeCol = 1;
    int freezeRow = 1;

    if (freezeCol >= 0 && freezeRow >= 0)
    {
        workSheet.CreateFreezePane(freezeCol, freezeRow);
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).");
    }
    else
    {
        Console.WriteLine("Invalid freeze pane parameters -- skipping.");
    }

    workBook.SaveAs("output.xlsx");
    Console.WriteLine("Workbook saved successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Error applying freeze pane: {ex.Message}");
}

Imports IronXL
Imports System

Try
    Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
    Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

    Dim freezeCol As Integer = 1
    Dim freezeRow As Integer = 1

    If freezeCol >= 0 AndAlso freezeRow >= 0 Then
        workSheet.CreateFreezePane(freezeCol, freezeRow)
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).")
    Else
        Console.WriteLine("Invalid freeze pane parameters -- skipping.")
    End If

    workBook.SaveAs("output.xlsx")
    Console.WriteLine("Workbook saved successfully.")
Catch ex As Exception
    Console.WriteLine($"Error applying freeze pane: {ex.Message}")
End Try

Imports IronXL
Imports System

Try
    Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
    Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

    Dim freezeCol As Integer = 1
    Dim freezeRow As Integer = 1

    If freezeCol >= 0 AndAlso freezeRow >= 0 Then
        workSheet.CreateFreezePane(freezeCol, freezeRow)
        Console.WriteLine($"Freeze pane set: {freezeCol} column(s), {freezeRow} row(s).")
    Else
        Console.WriteLine("Invalid freeze pane parameters -- skipping.")
    End If

    workBook.SaveAs("output.xlsx")
    Console.WriteLine("Workbook saved successfully.")
Catch ex As Exception
    Console.WriteLine($"Error applying freeze pane: {ex.Message}")
End Try

Bu desen, API'yi çağırmadan önce parametreleri doğrular ve kaydetme işlemini bir try-catch bloğuna sarar, böylece dosya sistemi veya format hataları temiz bir şekilde yakalanır. Sunucu taraflı rapor üretimi için bu tür savunmacı kod, toplu işleme hatlarının sessizce başarısız olmasını engeller.

IronXL dokümantasyonunda Excel çalışma sayfalarıyla çalışmak ve Excel grafiklerini oluşturup düzenlemek için daha fazla desen bulabilirsiniz; bu kütüphane, desteklenen elektronik tablo işlemlerinin tüm yelpazesini kapsar.

Dondurulmuş Bölmeleri Diğer IronXL Özellikleriyle Nasıl Birleştirirsiniz?

Dondurulmuş bölmeler, diğer elektronik tablo biçimlendirme ve veri işlemleriyle birleştirildiğinde daha da değerli hale gelir. Gerçek dünyadaki .NET uygulamalarındaki en yaygın kombinasyonlar şunlardır:

Dondurulmuş bölmelerle başlık biçimlendirme. Üst sırayı dondurun ve ardından başlık hücrelerine kalın biçimlendirme, arka plan rengi veya kenar stilleri uygulayın, böylece bunlar aşağıdaki veri satırlarından açıkça öne çıksın. Kullanıcılar, dondurulmuş sıranın hemen bir başlık olduğunu, bir veri satırı olmadığını fark ederler.

Otomatik sütun genişliği ayarlama. Verileri doldurduktan sonra, her sütunun içeriği için tam olarak yeterince geniş olması için otomatik sütun genişliği ayarlama işlemi gerçekleştirin. Bu, kesilen metinleri ortadan kaldırır ve dondurulmuş başlık etiketlerini bir bakışta okunabilir hale getirir.

Veri doğrulama ve hücre koruması. Başlık hücrelerini yanlışlıkla düzenlemeye karşı kilitlemek için dondurulmuş panelleri hücre koruması ile birleştirin. Son kullanıcılar verilerle etkileşimde bulunabilir ve kaydırabilirken, korunan başlık satırı dondurulmuş ve salt okunur kalır.

Sıralama ve filtreleme. Dondurmadan önce başlık satırına Excel Otomatik Filtre uygulayın. Kullanıcılar dosyayı açtıklarında, üst kısmına sabitlenmiş filtrelenebilir sütun başlıklarını görürler - bu, yerel Excel uygulamalarından tanıdık bir desendir.

Microsoft'un Excel dokümantasyonu'na göre, dondurulmuş paneller OOXML paketinin içinde, çalışma sayfasının sheetView XML elemanında depolanır. IronXL bu unsuru doğru yazar, böylece kütüphanenin ürettiği dosyalar Excel, LibreOffice ve Google Sheets üzerinde ek bir yapılandırma olmaksızın açılır.

Apache POI projesi -- Excel manipülasyonu için Java eşdeğeri -- aynı temel OOXML belirtimini kullanır, bu yüzden dondurulmuş bölme davranışı, Java geliştiricilerinin kendi araçlarını bekledikleriyle tutarlıdır.

Sonraki Adımlarınız Neler?

Dondurulmuş bölmeleri uygulamak, .NET Excel raporlarınızın kullanıcı deneyimini iyileştirmenin en etkili yollarından biridir. Başlıkları ve tanımlayıcıları yerine kilitleyerek, statik verileri, kullanıcıların güvenle gezinmesini sağlayan etkileşimli bir raporlama aracına dönüştürürsünüz.

Bu kılavuzda ele alınanların özeti şöyledir:

• Basit satır donması -- CreateFreezePane(0, 1) dikey kaydırma için üst satırı kilitler.
• Basit sütun donması -- CreateFreezePane(1, 0) yatay kaydırma için en soldaki sütunu kilitler.
• Kombine donma -- CreateFreezePane(1, 1) hem üst satırı hem de ilk sütunu kilitler.
• Gelişmiş ön kaydırma -- CreateFreezePane(col, row, leftmostCol, topRow) kaydırma paneli için özel bir başlangıç konumu ayarlar.
• Panelleri kaldır -- RemovePane() mevcut tüm dondurma veya bölme konfigürasyonunu temizler.
• Çoklu sayfa uygulaması -- Tüm çalışma kitabı boyunca aynı donma ayarlarını uygulamak için workBook.WorkSheets üzerinde tekrarlayın.

Bu becerileri geliştirmeye devam etmek için, IronXL belgelerindeki bu ilgili kılavuzları inceleyin:

• Mevcut elektronik tabloları yükleyip okuyun
• Yeni çalışma kitapları ve çalışma sayfaları oluşturun
• Satır ve sütun ekleyin ve kaldırın
• Hücre biçimlendirmesi ve stilleri uygulayın
• Excel grafikleriyle çalışın
• Hücre aralıklarını sıralayın ve filtreleyin
• Koşullu biçimlendirme uygulayın
• Çalışma kitaplarını ve çalışma sayfalarını koruyun

Üretim kullanımı için, tüm özelliklerin kilidini açmak ve güvenle dağıtım yapmak için bir lisans satın alın. IronXL lisans sayfası ayrıca dağıtım seçenekleri, telif ücreti ücretsiz yeniden dağıtım ve SaaS kullanım durumlarını kapsar.

İlk Adım:

Ücretsiz Başlayın