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 スプレッドシートの列 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");

行と列の両方を一緒に固定するにはどうすればよいでしょうか?

複雑な 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 は、4 つのパラメータを使用した高度なオプションを提供し、事前にスクロールされた開始位置を持つフリーズ ペインを追加できます。 これは、どの行と列を固定するかだけでなく、ユーザーが最初にファイルを開いたときにスクロール領域がどこから始まるかも制御します。

これは、ダッシュボードやエグゼクティブ レポートで、最初のビューを特定のデータ セクションに配置する場合に便利です。たとえば、固定されたヘッダー行と 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();

この 1 行により、ワークシート上に存在するすべての固定ペインがクリアされ、新しい書式設定を作成したり、固定セクションのないドキュメントのままにしたりできるようになります。 RemovePane を呼び出した後、すぐに新しいパラメータを使用して再度 CreateFreezePane を呼び出すことができます。この 2 つの操作は自然に連鎖します。

ファイル形式の制限により、Microsoft Excel 97-2003 (.xls) 形式ではウィンドウ枠の固定は機能しないことに注意してください。 最良の結果を得るには、ドキュメントを .xlsx ファイルとして保存してください。 ダウンロードしたファイルで固定ウィンドウが正しく表示されないという問題が発生した場合は、互換性のある Excel バージョンを使用していること、およびファイルが最新の形式で保存されていることを確認してください。

フリーズペインの削除を他のワークシート操作と組み合わせることもできます。 たとえば、レポートを別のレイアウトにエクスポートする前に、固定構成を削除し、新しい行と列を追加し、データを再構築してから、更新されたレイアウトに一致する新しい固定構成を適用することができます。

複数のワークシートにわたってウィンドウ枠の固定を適用するにはどうすればよいですか?

多くの Excel ブックには、部門、地域、または期間ごとに 1 つずつ、複数のワークシートが含まれています。 各シートに固定ウィンドウ枠を適用すると、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");

このパターンは、各シートが 1 か月を表す四半期財務パックや、各地域に独自のタブがある複数地域の売上レポートに特に便利です。 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 ブロックでラップして、ファイル システムまたは形式のエラーがすべて適切にキャッチされるようにします。 サーバー側のレポート生成では、この種の防御コードはバッチ処理パイプラインでのサイレント障害を防止します。

Excel ワークシートの操作やExcel グラフの作成に関するその他のパタ​​ーンについては、ライブラリがサポートするスプレッドシート操作の全範囲を網羅したIronXLドキュメントをご覧ください。

フリーズペインを他のIronXL機能と組み合わせるにはどうすればよいでしょうか?

固定ウィンドウは、他のスプレッドシートの書式設定やデータ操作と組み合わせると、さらに価値が高まります。 実際 for .NETアプリケーションで最も一般的な組み合わせは次のとおりです。

固定ペインを使用したヘッダーの書式設定。先頭行を固定し、ヘッダーセルに太字の書式、背景色、または境界線のスタイルを適用して、下のデータ行から明確に目立つようにします。 ユーザーは、固定された行がデータ行ではなくヘッダーであることにすぐに気付きます。

列幅を自動調整します。データを入力した後、各列の幅がコンテンツにぴったり合うように自動的に調整されます。 これにより、切り捨てられたテキストがなくなり、固定されたヘッダー ラベルが一目でわかるようになります。

データの検証とセルの保護。固定ウィンドウとセルの保護を組み合わせることで、ヘッダーセルをロックし、誤って編集されるのを防ぎます。 保護されたヘッダー行が固定され読み取り専用になっている間も、エンド ユーザーはデータをスクロールしたり操作したりできます。

並べ替えとフィルタリング。ヘッダー行を固定する前に、 Excel のオートフィルターを適用します。 ユーザーがファイルを開くと、フィルター可能な列ヘッダーが上部に固定表示されます。これは、ネイティブの Excel アプリケーションでおなじみのパターンです。

Microsoft の Excel ドキュメントによると、固定ペインは OOXML パッケージ内のワークシートの sheetView XML 要素に保存されます。 IronXL はこの要素を正しく書き込むため、ライブラリによって生成されたファイルは追加の構成なしで Excel、LibreOffice、 Google Sheetsで開くことができます。

Excel 操作の Java 版であるApache POI プロジェクトでは、同じ基礎 OOXML 仕様が使用されているため、ペインのフリーズ動作は Java 開発者が独自のツールに期待するものと一致しています。

次のステップは何ですか?

固定ウィンドウを実装することは、 .NET Excel レポートのユーザー エクスペリエンスを向上させる最も効果的な方法の 1 つです。 ヘッダーと識別子を固定することで、静的データをユーザーが安心して操作できるインタラクティブなレポート ツールに変換できます。

このガイドで説明した内容の概要は次のとおりです。

-単純な行固定-- CreateFreezePane(0, 1) は垂直スクロールの一番上の行をロックします。 -単純な列固定-- CreateFreezePane(1, 0) は、水平スクロール用に左端の列をロックします。 -複合フリーズ-- CreateFreezePane(1, 1) は最上行と最初の列の両方をロックします。 -高度な事前スクロール- CreateFreezePane(col, row, leftmostCol, topRow) は、スクロール ペインのカスタム開始位置を設定します。 -ペインを削除する-- RemovePane() は、既存のフリーズまたは分割構成をクリアします。 -複数シートのアプリケーション- workBook.WorkSheets を反復処理して、ブック全体に同じフリーズ設定を適用します。

これらのスキルをさらに磨くには、 IronXLドキュメントの関連ガイドを参照してください。

-既存のスプレッドシートを読み込んで読み込む -新しいワークブックとワークシートを作成する -行と列を追加および削除する -セルの書式とスタイルを適用する

• Excel グラフの操作 -セル範囲の並べ替えとフィルタリング -条件付き書式を適用する -ワークブックとワークシートを保護する

実稼働環境で使用する場合は、ライセンスを購入してすべての機能のロックを解除し、安心して導入してください。 IronXLライセンス ページでは、展開オプション、ロイヤリティフリーの再配布、SaaS の使用例についても説明します。

今IronXLを始めましょう。

無料で始める