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

.NET Projeniz için IronXL'i Nasıl Yüklersiniz?

Herhangi bir dondurulmuş bölme kodu yazmadan önce, IronXL'i NuGet Paket Yöneticisi kullanarak projenize ekleyin. Terminalinizi açın ve çalıştırın:

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

Alternatif olarak, Visual Studio Paket Yöneticisi Konsolu'nu kullanın:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

Kurulumdan sonra, dosyanızın en üstüne IronXL ad alanını ekleyin. IronXL, .NET 10'u hedefler ve Windows, Linux ve macOS dahil tüm büyük platformları destekler, böylece donma bölmesi mantığınız nerede dağıtırsanız dağıtın aynı şekilde çalışır.

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

Bir Excel Dosyasında Satırlar Nasıl Dondurulur?

Cevap basit: e-tablonuzda CreateFreezePane metodunu kullanın. Bu yöntem, çalışma sayfanızın geri kalanı özgürce kayarken hangi satırların ve sütunların görülebilir olduğuna karar veren parametreleri kabul eder. İlk satırı dondurduğunuzda, başlığınız ne kadar veri aşağı kayarsanız kayın üstte kilitli kalır, tıpkı Excel'in yerel Dondurulmuş Bölme özelliği gibi.

Aşağıdaki kod parçası, mevcut bir Excel belgesi yükleme ve üst satırı dondurmanın nasıl yapılacağı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 metodundaki parametreleri ayarlayın. Bu, Excel elektronik tablonuzda A sütununda tanımlayıcı bilgiler bulunduğunda, sağa kayarken görünür tutmak isteyebileceğinizde faydalıdır.

Aşağıdaki kod parçası, yeni bir çalışma kitabı oluşturma ve ilk sütunu dondurmanın nasıl yapılacağı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")

Satırları ve Sütunları Birlikte Nasıl Dondurursunuz?

Karmaşık Excel belgelerini işleyen uygulamalar için, hem üst satırı hem de ilk sütunu eşzamanlı olarak kilitleyen dondurulmuş bölmeler dondurmanız gerekebilir. Bu, başlık etiketlerinizi ve satır tanımlayıcılarınızı hangi yöne kaydırırsanız kaydırın görünür tutarak, hücre verilerinizi anlamayı ve filtrelemeyi 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")

Kaydırma Öncesi ile Gelişmiş Dondurulmuş Bölme Yöntemi Nasıl Kullanılır?

IronXL, kaydırma öncesi bir başlangıç pozisyonu ile dondurulmuş bölmeler eklemenizi sağlayan dört parametreli gelişmiş bir seçenek sunar. Bu, yalnızca hangi satır ve sütunların dondurulacağını değil, aynı zamanda kullanıcıların dosyayı ilk açtığında kaydırma alanının nerede başlayacağını kontrol eder.

Bu, gösterge panoları veya yönetici raporları için başlangıç görünümünün belirli bir veri bölümüne -- örneğin, bu ayın verilerini hemen gösterirken dondurulmuş başlık satırını ve Kimlik sütununu görünür tutmak -- inmesine istediğinizde faydalı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ının Sabit Pencerelerini Nasıl Kaldırırsınız?

Dondurma bölmeleri halihazırda varsa ve onları çıkarmanız gerekiyorsa, RemovePane metodu bunu temiz bir şekilde halleder. Bu, farklı bir sabit pencere yapılandırması kurmanız gerektiğinde ya da sayfayı normal kaydırmaya döndürmek için faydalıdır.

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

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

Bu tek satir, calisma sayfasinda var olan sabit pencereleri temizler, size yeni bir formatlama oluşturma veya belgede sabit bolgumler olmadan birakma imkani verir. RemovePane çağrısının ardından, yeni parametrelerle tekrar CreateFreezePane çağırabilirsiniz - iki işlem doğal bir şekilde bir araya gelir.

Dondurma bölmelerinin dosya formatı sınırlamaları nedeniyle Microsoft Excel 97-2003 (.xls) formatı ile çalışmadığını unutmayın. En iyi sonuçlar için belgelerinizi .xlsx dosyaları olarak kaydedin. İndirilen dosyaların sabit pencereleri doğru şekilde göstermediği bir sorunla karşılaşırsanız, uyumlu bir Excel sürümü kullandığınızı ve dosyanın modern formatta kaydedildiğini doğrulayın.

Sabit pencere kaldırma işlemini diğer çalışma sayfası işlemleri ile de eşleştirmeniz mümkündür. Örneğin, farklı bir düzene rapor ihraç etmeden önce, sabit pencere yapılandırmasını kaldırabilir, yeni satır ve sütunlar ekleyebilir, verileri yapılandırabilir ve ardından güncellenmiş düzene uygun yeni bir sabit pencere yapılandırması uygulayabilirsiniz.

Birden Çok Çalışma Sayfası Üzerine Sabit Pencereler Nasıl Uygulanır?

Birçok Excel çalışma kitabı, departman, bölge veya zaman dilimi başına birer tane olmak üzere birkaç çalışma sayfası içerir. Her sayfaya programatik olarak sabit pencereler uygulamak, Excel uygulamasında manuel olarak yapmaktan daha fazla zaman kazandırır.

Aşağıdaki örnek, bir çalışma kitabını yükler, tüm çalışma sayfalarını yineler ve her birine aynı sabit pencere konfigürasyonunu 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, özellikle her sayfanın bir ayı temsil ettiği üç aylık mali paketler veya her bölgenin kendi sekmesini aldığı çok bölgeli satış raporları için pratiktir. Excel veri aralığını sıralamak ve koşullu biçimlendirme uygulamak ile birleştirildiğinde, koddan tamamen biçimlendirilmiş, paylaşmaya hazır çalışma kitapları oluşturabilirsiniz.

IronXL, ayrıca, daha derin çalışma kitabı incelemesi için size WorkBook nesne modeline erişim sağlar. Sayfa sayısını kontrol edebilir, sayfaları isim veya index ile alabilir ve içerik türüne göre farklı sayfalara farklı sabit pencere konfigürasyonları uygulayabilirsiniz -- örneğin, bir özet sayfası sadece üst satırı dondurabilirken, detay sayfaları hem bir satırı hem de bir sütunu dondurabilir.

Kaydetmeden Önce Sabit Pencere Ayarlarını Nasıl Doğrularsınız?

Üretim kodunda, dosyayı diske yazmadan önce sabit pencere konfigürasyonunu doğrulamak iyi bir uygulamadır. IronXL şu anda sabit pencere durumu için doğrudan bir geri okuma API'si sağlamaz, bu nedenle önerilen yaklaşım, konfigürasyonu kendi kodunuzda izlemek ve kaydetme işleminin hatasız tamamlandığını belirtmektir.

Herhangi bir .NET 10 projesine uygulayabileceğiniz bir savunmacı kodlama deseni işte burada:

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 aramadan önce parametreleri doğrular ve herhangi bir dosya sistemi veya format hatası düzgün bir şekilde yakalanacak şekilde kaydetme işlemini bir try-catch bloğuna sarar. Bu tür savunma kodu, sunucu tarafı rapor oluşturma işlemlerinde toplu işleme hatalarının sessiz bir şekilde başarısız olmasını önler.

Excel çalışma sayfalarıyla çalışma ve Excel grafikleri oluşturma için daha fazla kalıbı IronXL dokümantasyonunda bulabilirsiniz, bu kitaplık tarafından desteklenen tam çalışma sayfası işlemlerini kapsamaktadır.

Sabit Pencereleri Diğer IronXL Özellikleriyle Nasıl Birleştirebilirsiniz?

Sabit pencereler, diğer elektronik tablo biçimlendirme ve veri işlemleri ile birleştirildiğinde daha da değer kazanmaktadır. Gerçek dünya .NET uygulamalarında en yaygın kombinasyonlar şunlardır:

Başlık biçimlendirme ile sabit pencereler. Üst satırı dondurun ve ardından verilerin altındaki satırlardan açıkça ayırt edilsin diye başlık hücrelerine kalın biçimlendirme, arka plan rengi veya kenar stilini uygulayın. Kullanıcılar hemen dondurulmuş satırın bir başlık satırı olduğunu fark eder, veri satırı olmadığını.

Otomatik sütun genişlik ayarı. Veri girdikten sonra, her sütunun içeriği için tam olarak yeterince geniş olmasını sağlamak üzere sütun genişliklerini otomatik ayarlayın. Bu, kesilmiş metni ortadan kaldırır ve dondurulmuş başlık etiketlerini hızlıca okunabilir hale getirir.

Veri doğrulama ve hücre koruması. Başlık hücrelerini yanlışlıkla düzenlemeye karşı kilitlemek için hücre koruması ile sabit pencereleri birleştirin. Son kullanıcılar verilerle etkileşime geçebilirken, korunan başlık satırı sabit ve salt okunur kalır.

Sıralama ve filtreleme. Sabitlemeden once, ust satira Excel Otomatik Filtre uygulayın. Kullanıcılar dosyayı açtığında, en üstte sabitlenmiş filtrelenebilir sütun başlıklarını görürler -- bunun gibi bir model, yerel Excel uygulamalarından tanıdık gelecektir.

Microsoft'un Excel belgelerine göre, dondurma bölmeleri, OOXML paketinin içindeki çalışma sayfasının sheetView XML elemanında saklanır. IronXL bu öğeyi doğru bir şekilde yazar, bu nedenle Iron Software ürünleri tarafından üretilen dosyalar Excel, LibreOffice ve Google Sheets içinde ek bir konfigürasyona ihtiyaç duymadan açılır.

Apache POI projesi -- Excel isleyisi icin Java esdegeri -- ayni OOXML spesifikasyonunu kullanir, bu nedenle sabit pencere davranışı Java geliştiricilerinin kendi araçlarından beklediği ile tutarlıdır.

Sıradaki Adımlarınız Neler?

Sabit pencereleri uygulamak, .NET Excel raporlarınızın kullanım deneyimini iyileştirmenin en etkili yollarından biridir. Başlıkları ve tanımlayıcıları yerinde kilitleyerek, kullanıcıların güvenle gezinebileceği etkileşimli bir raporlama aracı olarak statik verileri dönüştürüyorsunuz.

İşte bu rehberin kapsadığı konuların özeti:

• Basit satır dondurma -- CreateFreezePane(0, 1), kaydırma sırasında üst satırı kilitler.
• Basit sütun dondurma -- CreateFreezePane(1, 0), kaydırma sırasında en sol sütunu kilitler.
• Kombine dondurma -- CreateFreezePane(1, 1), hem üst satırı hem de ilk sütunu kilitler.
• Gelişmiş ön kaydırma -- CreateFreezePane(col, row, leftmostCol, topRow), kaydırılabilir pencere için özel bir başlangıç pozisyonu ayarlar.
• Bölmeleri kaldır -- RemovePane(), mevcut her türlü dondurma veya bölme yapılandırmasını temizler.
• Çoklu sayfa uygulaması -- Tüm bir çalış kitabında aynı dondurma ayarlarını uygulamak için workBook.WorkSheets üzerinde yineleyin.

Bu becerileri geliştirmeye devam etmek için, IronXL dokümantasyonundaki ilgili rehberleri keşfedin:

• Mevcut çalışma sayfalarını yükleyin ve okuyun
• Yeni çalışma kitapları ve sayfaları oluşturun
• Satır ve sütunlar ekleyin ve kaldırın
• Hücre formatlama ve stilleri uygulayın
• Excel grafikleri ile çalışın
• Hücre aralıklarını sıralayıp filtreleyin
• Koşullu biçimlendirme uygulayın
• Çalışma kitapları ve çalışma sayfalarını koruyun

Uretim kullanimi icin, tüm özellikleri etkinlestirip guvenle devreye almaniz adina bir lisans satin alin. IronXL lisanslama sayfası aynı zamanda dağıtım seçenekleri, telif ücretsiz yeniden dağıtım ve SaaS kullanım senaryolarını da kapsamaktadır.

Şimdi IronXL ile başlayın.

Ücretsiz Başlayın