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 形式が必要です。 以下の表は、このガイドで取り上げる主要なメソッドをまとめたものです。

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には、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");

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

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

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

このパターンは、各シートが1か月を表す四半期ごとの財務報告書や、各地域ごとにタブが設けられる複数地域にわたる売上報告書などに特に実用的です。 Excelの範囲データを並べ替えたり、条件付き書式を適用したりすることと組み合わせることで、完全に書式設定済みで共有可能なワークブックをコードだけで作成できます。

IronXL、ワークブックの詳細な検査を行うためのワークブックオブジェクトモデルにもアクセスできます。 シート数を確認したり、名前やインデックスでシートを検索したり、コンテンツの種類に基づいて異なるシートに異なる固定設定を適用したりできます。たとえば、概要シートでは最上行のみを固定し、詳細シートでは行と列の両方を固定するといったことが可能です。

保存する前に、ウィンドウ枠の固定設定を検証するにはどうすればよいですか？

本番環境のコードでは、ファイルをディスクに書き込む前に、フリーズペインの設定を確認するのが良い習慣です。 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アプリケーションでおなじみのパターンです。

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を始めましょう。

無料で始める