first commit

This commit is contained in:
2026-03-20 08:52:16 +09:00
commit 8c0b02233e
41 changed files with 6021 additions and 0 deletions

View File

@@ -0,0 +1,143 @@
using System;
using System.Collections.Generic;
using System.IO;
using OfficeOpenXml;
namespace Keps.WinForms.Infrastructure
{
public sealed class ExcelEpplusReader : IDisposable
{
private ExcelPackage _package;
/// <summary>
/// 지정된 경로의 Excel 파일(.xlsx/.xlsm)을 열고 내부 패키지를 초기화합니다.
/// </summary>
/// <param name="path">읽어들일 Excel 파일 경로.</param>
/// <exception cref="FileNotFoundException">파일이 존재하지 않을 때 발생합니다.</exception>
/// <exception cref="NotSupportedException">지원하지 않는 확장자일 때 발생합니다.</exception>
public void Open(string path)
{
if (string.IsNullOrWhiteSpace(path) || !File.Exists(path))
{
throw new FileNotFoundException("Excel 파일을 찾을 수 없습니다.", path);
}
string extension = Path.GetExtension(path);
if (!string.Equals(extension, ".xlsx", StringComparison.OrdinalIgnoreCase) &&
!string.Equals(extension, ".xlsm", StringComparison.OrdinalIgnoreCase))
{
throw new NotSupportedException(
"EPPlus 4.5.3.3은 .xlsx/.xlsm만 직접 지원합니다. 입력 파일을 .xlsx로 변환한 뒤 다시 시도하세요.");
}
_package = new ExcelPackage(new FileInfo(path));
}
/// <summary>
/// 현재 열려 있는 Excel 패키지의 모든 워크시트를 순회 가능한 형태로 반환합니다.
/// </summary>
/// <returns><see cref="ExcelSheet"/> 열거 시퀀스.</returns>
/// <exception cref="InvalidOperationException">Open이 선행되지 않은 경우 발생합니다.</exception>
public IEnumerable<ExcelSheet> ReadSheets()
{
if (_package == null)
{
throw new InvalidOperationException("먼저 Open을 호출해야 합니다.");
}
foreach (ExcelWorksheet worksheet in _package.Workbook.Worksheets)
{
if (worksheet == null)
{
continue;
}
yield return new ExcelSheet(worksheet);
}
}
/// <summary>
/// 내부 Excel 패키지 리소스를 해제합니다.
/// </summary>
public void Dispose()
{
if (_package != null)
{
_package.Dispose();
_package = null;
}
}
}
public sealed class ExcelSheet
{
private readonly ExcelWorksheet _worksheet;
/// <summary>
/// EPPlus의 <see cref="ExcelWorksheet"/>를 래핑하는 시트를 생성합니다.
/// </summary>
/// <param name="worksheet">원본 워크시트 인스턴스.</param>
public ExcelSheet(ExcelWorksheet worksheet)
{
_worksheet = worksheet;
}
public string Name
{
get { return _worksheet.Name; }
}
/// <summary>
/// 지정한 행/열 위치의 셀 값을 반환합니다. 범위를 벗어나면 null을 반환합니다.
/// </summary>
/// <param name="row">1부터 시작하는 행 번호.</param>
/// <param name="column">1부터 시작하는 열 번호.</param>
/// <returns>셀 값 또는 범위 밖일 경우 null.</returns>
public object GetValue(int row, int column)
{
if (_worksheet.Dimension == null)
{
return null;
}
if (row < 1 || column < 1)
{
return null;
}
if (row > _worksheet.Dimension.End.Row || column > _worksheet.Dimension.End.Column)
{
return null;
}
return _worksheet.Cells[row, column].Value;
}
/// <summary>
/// 첫 번째 행(헤더 행)에서 주어진 헤더 텍스트와 일치하는 열의 인덱스를 찾습니다.
/// </summary>
/// <param name="header">찾을 헤더 텍스트.</param>
/// <param name="maxColumn">검색을 수행할 최대 열 번호(1 기반).</param>
/// <returns>일치하는 열 번호(1 기반). 찾지 못하면 -1.</returns>
public int FindHeaderColumn(string header, int maxColumn)
{
if (_worksheet.Dimension == null || string.IsNullOrWhiteSpace(header))
{
return -1;
}
int endColumn = Math.Min(maxColumn, _worksheet.Dimension.End.Column);
for (int column = 1; column <= endColumn; column++)
{
object rawValue = _worksheet.Cells[1, column].Value;
string value = rawValue == null ? string.Empty : Convert.ToString(rawValue).Trim();
if (string.Equals(value, header, StringComparison.OrdinalIgnoreCase))
{
return column;
}
}
return -1;
}
}
}