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; } } }