151 lines
5.4 KiB
C#
151 lines
5.4 KiB
C#
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을 호출해야 합니다.");
|
|
}
|
|
|
|
if(_package.Workbook.Worksheets == null || _package.Workbook.Worksheets.Count == 0)
|
|
{
|
|
throw new InvalidOperationException(
|
|
"엑셀 시트를 읽을 수 없습니다. 파일이 Strict Open XML 형식이면 일반 Excel 통합 문서(.xlsx)로 다시 저장한 뒤 시도하세요."
|
|
);
|
|
}
|
|
|
|
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;
|
|
}
|
|
}
|
|
}
|