VB .NET Excel에서 맨 위 행 고정: 스크롤하는 동안 머리글이 보이도록 유지

IronXL을 .NET 프로젝트에 설치하는 방법은?

프리즈 창 코드를 작성하기 전에 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은 사전 스크롤 시작 위치로 고정 창을 추가할 수 있는 네 가지 매개변수를 사용하는 고급 옵션을 제공합니다. 이는 사용자가 파일을 처음 열 때 스크롤 영역이 어디서부터 시작되는지를 제어합니다.

대시보드 또는 경영 보고서를 위해 초기 보기가 특정 데이터 섹션--예를 들어 이번 달의 데이터를 즉시 표시하면서도 고정된 헤더 행과 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();

이 단일 줄은 워크시트에 존재하는 모든 고정 창을 지우고, 새로운 형식을 만들거나 고정되지 않은 섹션으로 문서를 남길 수 있게 합니다. 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으로 시작하세요.

무료로 시작하세요