.NET Excel凍結頂行：滾動時保持標題可見

如何為 .NET 專案安裝 IronXL？

在編寫任何凍結窗格程式碼之前，請使用 NuGet 套件管理員將 IronXL 新增至您的專案中。 打開終端機並運作：

dotnet add package IronXL.Excel

dotnet add package IronXL.Excel

或者，使用 Visual Studio 套件管理器控制台：

Install-Package IronXL.Excel

Install-Package IronXL.Excel

安裝完成後，請在檔案頂部新增 IronXL 命名空間。 IronXL 面向 .NET 10，並支援所有主流平台——Windows、Linux 和 macOS——因此無論部署在何處，凍結窗格邏輯都能以相同的方式運作。

安裝完成後，只需幾行程式碼即可載入現有工作簿或建立新工作簿。 本程式庫同時支援 .xlsx（Excel 2007 及更高版本）和 .xls（Excel 97-2003）格式，但凍結窗格支援需要現代的 .xlsx 格式。 下表總結了本指南中涵蓋的關鍵方法。

如何在Excel檔案中凍結行？

答案很簡單：在工作表物件上使用 CreateFreezePane 方法。 此方法接受參數，用於控制哪些行和列保持可見，而 Excel 表格的其餘部分可以自由滾動。 凍結第一行後，無論您向下捲動瀏覽資料到什麼程度，標題都會鎖定在頂部，類似於 Excel 的原生凍結窗格功能。

以下程式碼片段展示如何載入現有的 Excel 文件並凍結第一行：

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中凍結第一列？

若要凍結第一列而不是行，請調整 CreateFreezePane 方法中的參數。 當您的 Excel 電子表格 A 列包含標識符訊息，並且您希望在向右捲動其他列時保持該資訊可見時，此功能非常有用。

以下程式碼片段示範如何建立一個新的工作簿並凍結第一列：

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

如何同時凍結行和列？

對於處理複雜 Excel 文件的應用程序，您可能需要凍結窗格，同時鎖定頂行和第一列。 這樣，無論你朝哪個方向滾動，標題標籤和行標識符始終可見，從而更容易理解和篩選單元格資料。

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

如何使用具有預先捲動功能的"進階凍結窗格"方法？

IronXL 提供了一個使用四個參數的進階選項，可讓您新增具有預先捲動起始位置的凍結窗格。 這不僅可以控制哪些行和列被凍結，還可以控制使用者首次開啟檔案時滾動區域的起始位置。

這對於儀表板或高階主管報告非常有用，因為您希望初始視圖落在特定的數據部分上——例如，立即顯示本月的數據，同時保持凍結的標題行和 ID 列可見。

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

如何從工作表中刪除凍結窗格？

如果凍結窗格已經存在，並且你需要將其刪除，則 RemovePane 方法可以乾淨利落地處理這種情況。 當您需要安裝不同的凍結配置或將表格恢復為正常滾動時，這將非常有用。

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

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

這一行程式碼會清除工作表上所有凍結窗格，讓您可以建立新的格式或使文件不包含凍結部分。 呼叫 RemovePane 後，可以立即使用新的參數再次呼叫 CreateFreezePane -- 這兩個操作自然地連結在一起。

請注意，由於檔案格式的限制，凍結窗格不適用於 Microsoft Excel 97-2003 (.xls) 格式。 為獲得最佳效果，請將文件儲存為 .xlsx 文件。 如果下載的檔案無法正確顯示凍結窗格，請確認您使用的是相容的 Excel 版本，並且檔案以現代格式儲存。

您也可以將凍結窗格移除作業與其他工作表操作結合使用。 例如，在將報表匯出為不同的佈局之前，您可以刪除凍結配置，新增新的行和列，重新組織數據，然後套用與更新後的佈局相符的新凍結配置。

如何在多個工作表中套用凍結窗格？

許多 Excel 工作簿包含多個工作表—每個部門、地區或時間段一個工作表。 與在 Excel 應用程式中手動操作相比，透過程式設計方式將凍結窗格套用至每個工作表可以節省時間。

以下範例載入一個工作簿，遍歷所有工作表，並將相同的凍結配置應用於每個工作表：

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

這種模式對於季度財務報表（其中每個工作表代表一個月）或多區域銷售報告（其中每個區域都有自己的標籤頁）來說尤其實用。 結合對Excel 區域資料進行排序和應用條件格式，您可以完全透過程式碼建立格式完整、可直接共享的工作簿。

IronXL 還允許您存取WorkBook 物件模型，以便更深入地檢查工作簿。 您可以查看工作表數量，按名稱或索引檢索工作表，並根據工作表的內容類型對不同的工作表應用不同的凍結配置——例如，匯總工作表可能只凍結第一行，而明細工作表則凍結一行和一列。

如何在儲存前驗證凍結窗格設定？

在生產程式碼中，最佳實踐是在將檔案寫入磁碟之前驗證凍結窗格配置。 IronXL 目前沒有直接公開凍結窗格狀態的讀取 API，因此建議的方法是在自己的程式碼中追蹤配置，並斷言保存操作無誤地完成。

以下是一種可以應用於任何 .NET 10 專案的防禦性編碼模式：

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

此模式在呼叫 API 之前驗證參數，並將保存操作包裝在 try-catch 區塊中，以便乾淨利落地捕獲任何檔案系統或格式錯誤。 對於伺服器端報表生成，這種防禦性程式碼可以防止批次處理管道中出現靜默故障。

您可以在 IronXL 文件中找到更多關於使用 Excel 工作表和建立 Excel 圖表的模式，該文件涵蓋了該庫支援的所有電子表格操作。

如何將冷凍板與其他 IronXL 功能結合使用？

當與其他電子表格格式設定和資料操作結合使用時，凍結窗格的價值會更高。 在實際的 .NET 應用程式中，最常見的組合包括：

使用凍結窗格設定頁首格式。凍結頂行，然後對頁眉單元格套用粗體格式、背景顏色或邊框樣式，使其與下面的資料行清晰區分開來。 使用者會立即註意到，凍結的行是標題行而不是資料行。

自動調整列寬。資料填入完成後，自動調整列寬，使每個列的寬度剛好足以容納其內容。 這樣可以消除文字截斷，使凍結的標題標籤一目了然。

資料驗證和單元格保護。將凍結窗格與儲存格保護功能結合使用，可鎖定標題儲存格，防止意外編輯。 最終用戶可以滾動並與資料交互，而受保護的標題行保持凍結和唯讀狀態。

排序和篩選。在凍結標題行之前，先對標題行套用Excel 自動篩選功能。 當使用者開啟檔案時，他們會看到頂部固定的可篩選列標題——這是原生 Excel 應用程式中常見的模式。

根據微軟 Excel 文檔，凍結窗格儲存在 OOXML 套件中的工作表 sheetView XML 元素中。 IronXL 可以正確寫入此元素，因此該庫產生的檔案無需額外配置即可在 Excel、LibreOffice 和Google Sheets中開啟。

Apache POI 專案（Java 中用於 Excel 作業的等效專案）使用相同的底層 OOXML 規範，因此凍結窗格的行為與 Java 開發人員對其自身工具的期望一致。

下一步計劃是什麼？

實作凍結窗格是改善 .NET Excel 報表使用者體驗最有效的方法之一。 透過鎖定標頭和標識符，您可以將靜態資料轉換為使用者可以自信地瀏覽的互動式報告工具。

以下是本指南內容的概要：

-簡單行凍結-- CreateFreezePane(0, 1) 鎖定頂部行以進行垂直滾動。 -簡單列凍結-- CreateFreezePane(1, 0) 鎖定最左側列，使其無法水平滾動。 -組合凍結-- CreateFreezePane(1, 1) 同時鎖定頂行和第一列。 -進階預捲動-- CreateFreezePane(col, row, leftmostCol, topRow) 為捲動窗格設定自訂起始位置。 -刪除窗格-- RemovePane() 清除任何現有的凍結或分割配置。 -多工作表應用程式-- 遍歷 workBook.WorkSheets，以在整個工作簿中應用相同的凍結設定。

若要持續提升這些技能，請查閱 IronXL 文件中的以下相關指南：

-載入並讀取現有電子表格 -建立新的工作簿和工作表 -新增和刪除行和列 -套用儲存格格式和樣式 -使用 Excel 圖表 -對單元格區域進行排序和篩選 -應用條件格式 保護工作簿和工作表

如需用於生產環境，請購買許可證以解鎖所有功能並放心部署。 IronXL 許可頁面還涵蓋部署選項、免版稅再分發和 SaaS 用例。

!{--01001100010010010100001001010010010000010101001001011001010111110100011101000101010101 01000101111101010011010101000100000101010010010101000100010101000100010111110101011101001000110 1010101000100100001011111010100000101001001001111010001000101010101010000110101010100101010101011 10101010001010010010010010010000010100110001011111010000100100110001001111101000011010010111111010000110100101110--