VB.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格式。 下表總結了本指南中涵蓋的關鍵WorkSheet方法。

如何在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");

如何在Excel中凍結首列？

要凍結首列而不是行，可調整CreateFreezePane方法中的參數。 這在您的Excel工作表中包含需要在滾動其他列以右側的情況下保持可見的標識信息時非常有用。

下面的代碼片段演示創建新工作簿並凍結首列：

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

如何同時凍結行和列？

對於處理複雜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");

如何使用帶有預滾動功能的高級凍結窗格方法？

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

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

如果已經存在凍結窗格並且您需要刪除它們，可以使用RemovePane方法來清理。 當您需要安裝不同的凍結配置或將工作表返回到正常滾動時，這非常有用。

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

// Remove all existing freeze or split panes
workSheet.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");

此模式在季度財務包中特別適用，每個工作表代表一個月，或者在多地區銷售報告中，每個地區都有自己的標籤。 結合排序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}");
}

此模式在調用API之前驗證參數，並將保存操作包裹在try-catch塊中，以便在文件系統或格式錯誤時能夠幹淨地捕獲。 對於伺服器端報告生成，這種防禦性代碼在批量處理管道中防止了靜默失敗。

您可以在IronXL文檔中找到更多的處理Excel工作表和創建Excel圖表的模式，涵蓋了該程式庫支持的全部電子表格操作範圍。

如何將凍結窗格與其他IronXL功能結合使用？

當與其他電子表格格式化和數據操作相結合時，凍結窗格變得更加有價值。 在現實世界的.NET應用程序中，最常見的組合包括：

具有凍結窗格的標題格式化。 凍結頂行，然後將粗體格式、背景色或邊框樣式應用於標題單元，使它們清楚地從下方的數據行中突出。 用戶立即注意到凍結的行是標題而不是數據行。

自動適應列寬。 填充數據後，自动适应列宽以使每列的寬度恰好適合其內容。 這消除了截斷文本，使凍結的標題標籤一目了然。

數據驗證和單元格保護。 將凍結窗格與單元格保護結合使用以防止意外編輯標題單元格。 最終用戶可以滾動並操作數據，而受保護的標題行仍然凍結且只讀。

排序和篩選。 在凍結之前將Excel自動篩選應用於標題行。 當用戶打開文件時，他們看到可篩选的列标頭被固定在顶部——這是一種常見於原生Excel應用的模式。

根据Microsoft的Excel文档，凍結窗格存储在OOXML包内工作表的sheetView XML元素中。 IronXL正確編寫了此元素，因此程式庫生成的文件在Excel、LibreOffice和Google Sheets中無需額外配置即可打開。

Apache POI項目——Excel操作的Java等價——使用了相同的底層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使用案例。

現在開始使用 IronXL。

免費啟動