using System;
using System.Collections.Generic;
using System.IO;
using OfficeOpenXml;
namespace Keps.WinForms.Infrastructure
{
public sealed class ExcelEpplusReader : IDisposable
{
private ExcelPackage _package;
///
/// 지정된 경로의 Excel 파일(.xlsx/.xlsm)을 열고 내부 패키지를 초기화합니다.
///
/// 읽어들일 Excel 파일 경로.
/// 파일이 존재하지 않을 때 발생합니다.
/// 지원하지 않는 확장자일 때 발생합니다.
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));
}
///
/// 현재 열려 있는 Excel 패키지의 모든 워크시트를 순회 가능한 형태로 반환합니다.
///
/// 열거 시퀀스.
/// Open이 선행되지 않은 경우 발생합니다.
public IEnumerable ReadSheets()
{
if (_package == null)
{
throw new InvalidOperationException("먼저 Open을 호출해야 합니다.");
}
foreach (ExcelWorksheet worksheet in _package.Workbook.Worksheets)
{
if (worksheet == null)
{
continue;
}
yield return new ExcelSheet(worksheet);
}
}
///
/// 내부 Excel 패키지 리소스를 해제합니다.
///
public void Dispose()
{
if (_package != null)
{
_package.Dispose();
_package = null;
}
}
}
public sealed class ExcelSheet
{
private readonly ExcelWorksheet _worksheet;
///
/// EPPlus의 를 래핑하는 시트를 생성합니다.
///
/// 원본 워크시트 인스턴스.
public ExcelSheet(ExcelWorksheet worksheet)
{
_worksheet = worksheet;
}
public string Name
{
get { return _worksheet.Name; }
}
///
/// 지정한 행/열 위치의 셀 값을 반환합니다. 범위를 벗어나면 null을 반환합니다.
///
/// 1부터 시작하는 행 번호.
/// 1부터 시작하는 열 번호.
/// 셀 값 또는 범위 밖일 경우 null.
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;
}
///
/// 첫 번째 행(헤더 행)에서 주어진 헤더 텍스트와 일치하는 열의 인덱스를 찾습니다.
///
/// 찾을 헤더 텍스트.
/// 검색을 수행할 최대 열 번호(1 기반).
/// 일치하는 열 번호(1 기반). 찾지 못하면 -1.
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;
}
}
}