MiniExcel

Peponi │ 1/20/2025 │ 17m

NugetPackageExcel

MiniExcel

1/20/2025

17m

Peponi

NugetPackageExcel

1. Introduction

MiniExcel은 OOM을 피하기 위해 만들어진 .NET 라이브러리이다. Github의 readme를 보면, 아래와 같이 라이브러리 특징에 대해 소개하고 있다.

Features

Low memory consumption, avoid OOM (out of memory) and full GC

Support operation of each row of data real-time

Support LINQ deferred execution, it can do low-consumption, fast paging and other complex queries

Lightweight, without Microsoft Office installed, no COM+, DLL size is less than 150KB

Easy API style to read/write/fill excel

Readme에 올라와 있는 벤치마크 자료를 보면 메모리 사용량이 상당히 낮은데, 속도 또한 엄청나게 빠르다는 것을 알 수 있다. 실제로 사용해보니 상당히 유용하게 사용할 수 있을 것으로 생각되어 자료를 정리하여 남긴다. 아래에서는 다음 사례에 대해 소개한다.

Dynamic query
Dynamic query with header
Query with type
Query with LINQ
Query by sheet name
Query with merged cells
Save
Save with multiple sheets
Save with template

이 외에도 MiniExcel을 통해 많은 작업을 수행할 수 있다. 관심이 있다면 꼭 한번 Github 페이지에 방문하여 자세한 사용법을 알아보길 권장한다.

2. Dynamic query

불러올 데이터는 아래와 같다.

dynamicQuery

MiniExcel.Query(string)로 호출하며 IEnumerable<dynamic>을 반환한다. 코드 및 출력 결과는 아래와 같다.

private static void DynamicQuery(string dataPath)
{
    var datas = MiniExcel.Query(dataPath);
 
    foreach (var data in datas)
    {
        Console.WriteLine($"{data.A}, {data.B}, {data.C}, {data.D}");
    }
}

출력 데이터 (펼치기 / 접기)

ID, Name, PhoneNumber, SalesVolume
0, A, 010-0000-0000, 1000
1, B, 010-0000-0001, 1001
2, C, 010-0000-0002, 1002
3, D, 010-0000-0003, 1003
4, E, 010-0000-0004, 1004
5, F, 010-0000-0005, 1005
6, G, 010-0000-0006, 1006
7, H, 010-0000-0007, 1007
8, I, 010-0000-0008, 1008
9, J, 010-0000-0009, 1009
10, K, 010-0000-0010, 1010
11, L, 010-0000-0011, 1011
12, M, 010-0000-0012, 1012
13, N, 010-0000-0013, 1013
14, O, 010-0000-0014, 1014
15, P, 010-0000-0015, 1015
16, Q, 010-0000-0016, 1016
17, R, 010-0000-0017, 1017
18, S, 010-0000-0018, 1018
19, T, 010-0000-0019, 1019
20, U, 010-0000-0020, 1020
21, V, 010-0000-0021, 1021
22, W, 010-0000-0022, 1022
23, X, 010-0000-0023, 1023
24, Y, 010-0000-0024, 1024
25, Z, 010-0000-0025, 1025
26, AA, 010-0000-0026, 1026
27, AB, 010-0000-0027, 1027
28, AC, 010-0000-0028, 1028
29, AD, 010-0000-0029, 1029

3. Dynamic query with header

불러올 데이터는 아래와 같다.

dynamicQuery2

MiniExcel.Query(string, bool)로 호출하며 IEnumerable<dynamic>을 반환한다. 또한, 헤더 이름을 속성으로 사용하는 것이 가능해진다. 코드 및 출력 결과는 아래와 같다.

private static void DynamicQueryWithHeader(string dataPath)
{
    var datas = MiniExcel.Query(dataPath, true);
 
    foreach (var data in datas)
    {
        Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.SalesVolume}");
    }
}

출력 데이터 (펼치기 / 접기)

0, A, 010-0000-0000, 1000
1, B, 010-0000-0001, 1001
2, C, 010-0000-0002, 1002
3, D, 010-0000-0003, 1003
4, E, 010-0000-0004, 1004
5, F, 010-0000-0005, 1005
6, G, 010-0000-0006, 1006
7, H, 010-0000-0007, 1007
8, I, 010-0000-0008, 1008
9, J, 010-0000-0009, 1009
10, K, 010-0000-0010, 1010
11, L, 010-0000-0011, 1011
12, M, 010-0000-0012, 1012
13, N, 010-0000-0013, 1013
14, O, 010-0000-0014, 1014
15, P, 010-0000-0015, 1015
16, Q, 010-0000-0016, 1016
17, R, 010-0000-0017, 1017
18, S, 010-0000-0018, 1018
19, T, 010-0000-0019, 1019
20, U, 010-0000-0020, 1020
21, V, 010-0000-0021, 1021
22, W, 010-0000-0022, 1022
23, X, 010-0000-0023, 1023
24, Y, 010-0000-0024, 1024
25, Z, 010-0000-0025, 1025
26, AA, 010-0000-0026, 1026
27, AB, 010-0000-0027, 1027
28, AC, 010-0000-0028, 1028
29, AD, 010-0000-0029, 1029

4. Query with type

불러올 데이터는 아래와 같다.

dynamicQuery3

MiniExcel.Query<T>(string)로 호출하며 IEnumerable<T>를 반환한다. 코드 및 출력 결과는 아래와 같다.

public record Person
{
    public ulong ID { get; init; }
    public string? Name { get; init; }
    public string? PhoneNumber { get; init; }
}
 
public sealed record Customer : Person
{
    public ulong SalesVolume { get; init; }
}
 
private static void QueryWithType(string dataPath)
{
    var datas = MiniExcel.Query<Customer>(dataPath);
 
    foreach (var data in datas)
    {
        Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.SalesVolume}");
    }
}

출력 데이터 (펼치기 / 접기)

0, A, 010-0000-0000, 1000
1, B, 010-0000-0001, 1001
2, C, 010-0000-0002, 1002
3, D, 010-0000-0003, 1003
4, E, 010-0000-0004, 1004
5, F, 010-0000-0005, 1005
6, G, 010-0000-0006, 1006
7, H, 010-0000-0007, 1007
8, I, 010-0000-0008, 1008
9, J, 010-0000-0009, 1009
10, K, 010-0000-0010, 1010
11, L, 010-0000-0011, 1011
12, M, 010-0000-0012, 1012
13, N, 010-0000-0013, 1013
14, O, 010-0000-0014, 1014
15, P, 010-0000-0015, 1015
16, Q, 010-0000-0016, 1016
17, R, 010-0000-0017, 1017
18, S, 010-0000-0018, 1018
19, T, 010-0000-0019, 1019
20, U, 010-0000-0020, 1020
21, V, 010-0000-0021, 1021
22, W, 010-0000-0022, 1022
23, X, 010-0000-0023, 1023
24, Y, 010-0000-0024, 1024
25, Z, 010-0000-0025, 1025
26, AA, 010-0000-0026, 1026
27, AB, 010-0000-0027, 1027
28, AC, 010-0000-0028, 1028
29, AD, 010-0000-0029, 1029

5. Query with LINQ

불러올 데이터는 아래와 같다.

dynamicQuery4

MiniExcel.Query<T>(string)의 반환형이 IEnumerable<T>이기 때문에 LINQ 사용이 가능하다.

private static void QueryWithLINQ(string dataPath)
{
    var datas = MiniExcel.Query<Customer>(dataPath).Where(x => x.SalesVolume >= 1015);
 
    foreach (var data in datas)
    {
        Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.SalesVolume}");
    }
}

출력 데이터 (펼치기 / 접기)

15, P, 010-0000-0015, 1015
16, Q, 010-0000-0016, 1016
17, R, 010-0000-0017, 1017
18, S, 010-0000-0018, 1018
19, T, 010-0000-0019, 1019
20, U, 010-0000-0020, 1020
21, V, 010-0000-0021, 1021
22, W, 010-0000-0022, 1022
23, X, 010-0000-0023, 1023
24, Y, 010-0000-0024, 1024
25, Z, 010-0000-0025, 1025
26, AA, 010-0000-0026, 1026
27, AB, 010-0000-0027, 1027
28, AC, 010-0000-0028, 1028
29, AD, 010-0000-0029, 1029

6. Query by sheet name

엑셀 파일이 여러 sheet로 구성되어 있는 경우, sheet name을 이용해 해당 부분의 데이터를 불러올 수 있다. 불러올 데이터는 아래와 같다.

employeeSheet

여기서는 MiniExcel.Query<T>(string, string)을 이용한 예시를 보여준다.

public record Person
{
    public ulong ID { get; init; }
    public string? Name { get; init; }
    public string? PhoneNumber { get; init; }
}
 
public record Employee : Person
{
    public uint Age { get; init; }
    public DateTime Join { get; init; }
}
 
private static void QueryBySheetName(string dataPath)
{
    var datas = MiniExcel.Query<Employee>(dataPath, nameof(Employee));
 
    foreach (var data in datas)
    {
        Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.Age}, {data.Join}");
    }
}

출력 데이터 (펼치기 / 접기)

0, A, 010-0000-0000, 20, 2024-04-17 오전 12:00:00
1, B, 010-0000-0001, 21, 2024-04-18 오전 12:00:00
2, C, 010-0000-0002, 22, 2024-04-19 오전 12:00:00
3, D, 010-0000-0003, 23, 2024-04-20 오전 12:00:00
4, E, 010-0000-0004, 24, 2024-04-21 오전 12:00:00
5, F, 010-0000-0005, 25, 2024-04-22 오전 12:00:00
6, G, 010-0000-0006, 26, 2024-04-23 오전 12:00:00
7, H, 010-0000-0007, 27, 2024-04-24 오전 12:00:00
8, I, 010-0000-0008, 28, 2024-04-25 오전 12:00:00
9, J, 010-0000-0009, 29, 2024-04-26 오전 12:00:00
10, K, 010-0000-0010, 30, 2024-04-27 오전 12:00:00
11, L, 010-0000-0011, 31, 2024-04-28 오전 12:00:00
12, M, 010-0000-0012, 32, 2024-04-29 오전 12:00:00
13, N, 010-0000-0013, 33, 2024-04-30 오전 12:00:00
14, O, 010-0000-0014, 34, 2024-05-01 오전 12:00:00
15, P, 010-0000-0015, 35, 2024-05-02 오전 12:00:00
16, Q, 010-0000-0016, 36, 2024-05-03 오전 12:00:00
17, R, 010-0000-0017, 37, 2024-05-04 오전 12:00:00
18, S, 010-0000-0018, 38, 2024-05-05 오전 12:00:00
19, T, 010-0000-0019, 39, 2024-05-06 오전 12:00:00
20, U, 010-0000-0020, 40, 2024-05-07 오전 12:00:00
21, V, 010-0000-0021, 41, 2024-05-08 오전 12:00:00
22, W, 010-0000-0022, 42, 2024-05-09 오전 12:00:00
23, X, 010-0000-0023, 43, 2024-05-10 오전 12:00:00
24, Y, 010-0000-0024, 44, 2024-05-11 오전 12:00:00
25, Z, 010-0000-0025, 45, 2024-05-12 오전 12:00:00
26, AA, 010-0000-0026, 46, 2024-05-13 오전 12:00:00
27, AB, 010-0000-0027, 47, 2024-05-14 오전 12:00:00
28, AC, 010-0000-0028, 48, 2024-05-15 오전 12:00:00
29, AD, 010-0000-0029, 49, 2024-05-16 오전 12:00:00

7. Query with merged cells

아래 그림과 같이 병합된 셀이 있는 경우를 위해 MiniExcel에는 병합 셀에 대한 옵션을 지원한다.

departmentSheet

OpenXmlConfiguration클래스의 FillMergedCells 속성을 이용하여 설정 가능하다.

코드 및 출력 결과는 아래와 같다.

public record Person
{
    public ulong ID { get; init; }
    public string? Name { get; init; }
    public string? PhoneNumber { get; init; }
}
 
public record Employee : Person
{
    public uint Age { get; init; }
    public DateTime Join { get; init; }
}
 
public sealed record EmployeeWithDepartment : Employee
{
    public string? Department { get; init; }
}
 
private static void QueryWithMergedCells(string dataPath)
{
    var config = new OpenXmlConfiguration() { FillMergedCells = true };
    var datas = MiniExcel.Query<EmployeeWithDepartment>(dataPath, nameof(EmployeeWithDepartment.Department), configuration: config);
 
    foreach (var data in datas)
    {
        Console.WriteLine($"{data.Department}, {data.ID}, {data.Name}, {data.PhoneNumber}, {data.Age}, {data.Join}");
    }
}

출력 데이터 (펼치기 / 접기)

Infrastructure, 0, A, 010-0000-0000, 20, 2024-04-17 오전 12:00:00
Infrastructure, 1, B, 010-0000-0001, 21, 2024-04-18 오전 12:00:00
Infrastructure, 2, C, 010-0000-0002, 22, 2024-04-19 오전 12:00:00
Infrastructure, 3, D, 010-0000-0003, 23, 2024-04-20 오전 12:00:00
Infrastructure, 4, E, 010-0000-0004, 24, 2024-04-21 오전 12:00:00
Infrastructure, 5, F, 010-0000-0005, 25, 2024-04-22 오전 12:00:00
Infrastructure, 6, G, 010-0000-0006, 26, 2024-04-23 오전 12:00:00
Infrastructure, 7, H, 010-0000-0007, 27, 2024-04-24 오전 12:00:00
SW, 8, I, 010-0000-0008, 28, 2024-04-25 오전 12:00:00
SW, 9, J, 010-0000-0009, 29, 2024-04-26 오전 12:00:00
SW, 10, K, 010-0000-0010, 30, 2024-04-27 오전 12:00:00
SW, 11, L, 010-0000-0011, 31, 2024-04-28 오전 12:00:00
SW, 12, M, 010-0000-0012, 32, 2024-04-29 오전 12:00:00
SW, 13, N, 010-0000-0013, 33, 2024-04-30 오전 12:00:00
SW, 14, O, 010-0000-0014, 34, 2024-05-01 오전 12:00:00
SW, 15, P, 010-0000-0015, 35, 2024-05-02 오전 12:00:00
SW, 16, Q, 010-0000-0016, 36, 2024-05-03 오전 12:00:00
SW, 17, R, 010-0000-0017, 37, 2024-05-04 오전 12:00:00
SW, 18, S, 010-0000-0018, 38, 2024-05-05 오전 12:00:00
Law, 19, T, 010-0000-0019, 39, 2024-05-06 오전 12:00:00
Law, 20, U, 010-0000-0020, 40, 2024-05-07 오전 12:00:00
Law, 21, V, 010-0000-0021, 41, 2024-05-08 오전 12:00:00
Law, 22, W, 010-0000-0022, 42, 2024-05-09 오전 12:00:00
HQ, 23, X, 010-0000-0023, 43, 2024-05-10 오전 12:00:00
HQ, 24, Y, 010-0000-0024, 44, 2024-05-11 오전 12:00:00
HQ, 25, Z, 010-0000-0025, 45, 2024-05-12 오전 12:00:00
HQ, 26, AA, 010-0000-0026, 46, 2024-05-13 오전 12:00:00
HQ, 27, AB, 010-0000-0027, 47, 2024-05-14 오전 12:00:00
HQ, 28, AC, 010-0000-0028, 48, 2024-05-15 오전 12:00:00
HQ, 29, AD, 010-0000-0029, 49, 2024-05-16 오전 12:00:00

8. Save

MiniExcel은 일반적인 객체에 대해 상당히 쉬운 저장 방법을 제공한다.

public record Person
{
    public ulong ID { get; init; }
    public string? Name { get; init; }
    public string? PhoneNumber { get; init; }
}
 
public record Employee : Person
{
    public uint Age { get; init; }
    public DateTime Join { get; init; }
}
 
static void Save()
{
    List<Employee> employees = [];
    for (uint i = 0; i < 30; i++)
    {
        employees.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), Age = i + 20, Join = DateTime.Today.AddDays(i) });
    }
 
    string savePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(Employee)}.xlsx");
    MiniExcel.SaveAs(savePath, employees);
}

9. Save with multiple sheets

여러 sheet에 걸친 데이터도 쉽게 저장이 가능하다.

public record Person
{
    public ulong ID { get; init; }
    public string? Name { get; init; }
    public string? PhoneNumber { get; init; }
}
 
public sealed record Customer : Person
{
    public ulong SalesVolume { get; init; }
}
 
public record Employee : Person
{
    public uint Age { get; init; }
    public DateTime Join { get; init; }
}
 
static void SaveWithMultipleSheets()
{
    List<Customer> customers = [];
    List<Employee> employees = [];
    for (uint i = 0; i < 30; i++)
    {
        customers.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), SalesVolume = 1000 + i });
    }
    for (uint i = 0; i < 30; i++)
    {
        employees.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), Age = i + 20, Join = DateTime.Today.AddDays(i) });
    }
 
    // 각 키마다 하나의 sheet로 저장
    var multipleSheets = new Dictionary<string, object>
    {
        [nameof(customers)] = customers,
        [nameof(employees)] = employees
    };
 
    string savePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(multipleSheets)}.xlsx");
    MiniExcel.SaveAs(savePath, multipleSheets);
}

저장된 데이터는 아래와 같다.

multipleSheets

10. Save with template

MiniExcel.SaveAsByTemplate(string, string, object) 메서드를 사용하면 엑셀 파일의 내용을 템플릿화 하여 동적으로 저장하는 것이 가능하다. 개인적으로는 이 기능이 MiniExcel의 가장 큰 장점 중 하나가 아닐까 싶다.

템플릿은 아래와 같다.

template

기능 소개에 따르면 Vue 템플릿과 유사하다고 되어있다. {{Customers.속성}}으로 지정되어 있는 셀 (A2~D2) 을 인식하여 자동으로 데이터를 채워준다. 위 템플릿은 기능 테스트를 위해 차트와 B5, C3~C5에 수식이 걸려있다.

코드 및 출력 결과는 아래와 같다.

public record Person
{
    public ulong ID { get; init; }
    public string? Name { get; init; }
    public string? PhoneNumber { get; init; }
}
 
public sealed record Customer : Person
{
    public ulong SalesVolume { get; init; }
}
 
private static void SaveWithTemplate()
{
    List<Customer> customers = [];
    for (uint i = 0; i < 30; i++)
    {
        customers.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), SalesVolume = 1000 + i });
    }
 
    var saveObject = new
    {
        Customers = customers
    };
 
    string savePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(Customer)}.xlsx");
    string templatePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(Customer)}Template.xlsx");
    MiniExcel.SaveAsByTemplate(savePath, templatePath, saveObject);
}

templateResult

WARNING

특이사항으로는, 차트에 걸어둔 수식은 자동으로 동작하지만 셀에 걸려있는 수식은 그렇지 않다. 걸려 있는 수식을 수동으로 실행시키면 정상 동작 한다.

11. 테스트를 수행한 전체 코드

아래는 테스트를 수행한 전체 코드이다.

전체 코드 (펼치기 / 접기)

using MiniExcelLibs;
using MiniExcelLibs.OpenXml;
 
namespace MiniExcelTest
{
    public record Person
    {
        public ulong ID { get; init; }
        public string? Name { get; init; }
        public string? PhoneNumber { get; init; }
    }
 
    public sealed record Customer : Person
    {
        public ulong SalesVolume { get; init; }
    }
 
    public record Employee : Person
    {
        public uint Age { get; init; }
        public DateTime Join { get; init; }
    }
 
    public sealed record EmployeeWithDepartment : Employee
    {
        public string? Department { get; init; }
    }
 
    internal class Program
    {
        private static void Main(string[] args)
        {
            string dataFile = "MiniExcel.xlsx";
            string dataPath = Path.Combine(Environment.CurrentDirectory, dataFile);
 
            DynamicQuery(dataPath);
 
            Console.WriteLine("----------------------------------------------------");
 
            DynamicQueryWithHeader(dataPath);
 
            Console.WriteLine("----------------------------------------------------");
 
            QueryWithType(dataPath);
 
            Console.WriteLine("----------------------------------------------------");
 
            QueryWithLINQ(dataPath);
 
            Console.WriteLine("----------------------------------------------------");
 
            QueryBySheetName(dataPath, nameof(Employee));
 
            Console.WriteLine("----------------------------------------------------");
 
            QueryWithMergedCells(dataPath, nameof(EmployeeWithDepartment.Department));
 
            Console.WriteLine("----------------------------------------------------");
 
            Save();
            SaveWithMultipleSheets();
            SaveWithTemplate();
        }
 
        private static void DynamicQuery(string dataPath)
        {
            var datas = MiniExcel.Query(dataPath);
 
            foreach (var data in datas)
            {
                Console.WriteLine($"{data.A}, {data.B}, {data.C}, {data.D}");
            }
        }
 
        private static void DynamicQueryWithHeader(string dataPath)
        {
            var datas = MiniExcel.Query(dataPath, true);
 
            foreach (var data in datas)
            {
                Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.SalesVolume}");
            }
        }
 
        private static void QueryWithType(string dataPath)
        {
            var datas = MiniExcel.Query<Customer>(dataPath);
 
            foreach (var data in datas)
            {
                Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.SalesVolume}");
            }
        }
 
        private static void QueryWithLINQ(string dataPath)
        {
            var datas = MiniExcel.Query<Customer>(dataPath).Where(x => x.SalesVolume >= 1015);
 
            foreach (var data in datas)
            {
                Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.SalesVolume}");
            }
        }
 
        private static void QueryBySheetName(string dataPath, string sheetName)
        {
            var datas = MiniExcel.Query<Employee>(dataPath, sheetName);
 
            foreach (var data in datas)
            {
                Console.WriteLine($"{data.ID}, {data.Name}, {data.PhoneNumber}, {data.Age}, {data.Join}");
            }
        }
 
        private static void QueryWithMergedCells(string dataPath, string sheetName)
        {
            var config = new OpenXmlConfiguration() { FillMergedCells = true };
            var datas = MiniExcel.Query<EmployeeWithDepartment>(dataPath, sheetName, configuration: config);
 
            foreach (var data in datas)
            {
                Console.WriteLine($"{data.Department}, {data.ID}, {data.Name}, {data.PhoneNumber}, {data.Age}, {data.Join}");
            }
        }
 
        private static void Save()
        {
            List<Employee> employees = [];
            for (uint i = 0; i < 30; i++)
            {
                employees.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), Age = i + 20, Join = DateTime.Today.AddDays(i) });
            }
 
            string savePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(Employee)}.xlsx");
            MiniExcel.SaveAs(savePath, employees);
        }
 
        private static void SaveWithMultipleSheets()
        {
            List<Customer> customers = [];
            List<Employee> employees = [];
            for (uint i = 0; i < 30; i++)
            {
                customers.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), SalesVolume = 1000 + i });
            }
            for (uint i = 0; i < 30; i++)
            {
                employees.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), Age = i + 20, Join = DateTime.Today.AddDays(i) });
            }
 
            // 각 키마다 하나의 sheet로 저장
            var multipleSheets = new Dictionary<string, object>
            {
                [nameof(customers)] = customers,
                [nameof(employees)] = employees
            };
 
            string savePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(multipleSheets)}.xlsx");
            MiniExcel.SaveAs(savePath, multipleSheets);
        }
 
        private static void SaveWithTemplate()
        {
            List<Customer> customers = [];
            for (uint i = 0; i < 30; i++)
            {
                customers.Add(new() { ID = i, Name = i.ToString(), PhoneNumber = i.ToString("010-0000-0000"), SalesVolume = 1000 + i });
            }
 
            var saveObject = new
            {
                Customers = customers
            };
 
            string savePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(Customer)}.xlsx");
            string templatePath = Path.Combine(Environment.CurrentDirectory, $"{nameof(Customer)}Template.xlsx");
            MiniExcel.SaveAsByTemplate(savePath, templatePath, saveObject);
        }
    }
}

데이터 및 템플릿 파일을 포함한 전체 코드는 peponi-paradise/C-Sharp (Github)에서 확인 가능하다.

12. 참조 자료

mini-software/MiniExcel (Github)

Contents

1. Introduction
2. Dynamic query
3. Dynamic query with header
4. Query with type
5. Query with LINQ
6. Query by sheet name
7. Query with merged cells
8. Save
9. Save with multiple sheets
10. Save with template
11. 테스트를 수행한 전체 코드
12. 참조 자료