VB.NET Excel Üst Satır Dondur: Kaydırma Sırasında Başlıkları Görünür Tutun

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

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

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

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

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();

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

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

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.

Şimdi IronXL ile başlayın.

Ücretsiz Başlayın