.NET용 C# XLSX, ODS, CSV Office 불필요

XLSX 파일용 C# Excel 라이브러리

sgcDocs는 Office 설치 없이 Windows, Linux, macOS에서 수식, 스타일, 숫자 서식이 있는 XLSX 파일을 만들고 읽는 C# Excel 라이브러리예요.

Excel 함수 320개 계산 글꼴, 채우기, 테두리, 숫자 서식 ASP.NET Core, 서비스, Linux 같은 API의 DOCX와 PDF

sgcUI .NET Enterprise에 포함돼요. 가격 보기 →

using esegece.sgcDocs;

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.New();
    sheet.SetValues("A1", "Units");
    sheet.SetValues("A2", 12);
    sheet.SetValues("A3", 30);
    sheet.SetFormulas("A4", "=SUM(A2:A3)");
    sheet.Calculate();
    sheet.SaveToFile("units.xlsx");
    sheet.ExportToPDFFile("units.pdf");
}

C#에서 Excel 파일을 만드는 방법

Excel 없이 C#으로 Excel 파일을 만들려면 TsgcDocsSpreadsheet를 만들고 New를 호출한 다음, 셀 주소로 값과 수식을 쓰고, 셀을 서식화한 뒤 SaveToFile을 호출하세요. 형식은 파일 확장자로 정해지므로 같은 통합 문서를 ODS나 CSV로도 저장할 수 있어요.

using System;
using esegece.sgcDocs;
using esegece.sgcGrid;

static class SalesReport
{
    public static void Create()
    {
        using (var sheet = new TsgcDocsSpreadsheet())
        {
            sheet.New();
            sheet.RenameSheet(0, "Sales");

            // a header row and three data rows, from one and two dimensional arrays
            sheet.SetRange("A1", new object[] { "Product", "Units", "Price", "Total" });
            sheet.SetRange("A2", new object[,]
            {
                { "Paper", 12, 4.5 },
                { "Toner", 3, 39.9 },
                { "Labels", 20, 2.75 }
            });

            // formulas, calculated by the engine and saved with the file
            sheet.SetFormulas("D2", "=B2*C2");
            sheet.SetFormulas("D3", "=B3*C3");
            sheet.SetFormulas("D4", "=B4*C4");
            sheet.SetValues("A5", "Total");
            sheet.SetFormulas("D5", "=SUM(D2:D4)");

            // a bold, centred header with a fill colour (ARGB)
            TsgcGridCellFormat header = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            header.Bold = true;
            header.Alignment = TsgcGridAlignment.gaCenter;
            header.FillColor = 0xFFDDEBF7;
            sheet.SetFormat("A1:D1", header);

            // a number format for the money columns
            TsgcGridCellFormat money = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            money.NumberFormat = "#,##0.00";
            sheet.SetFormat("C2:D5", money);

            // column widths in DIPs
            sheet.SetColumnWidths("A", 140);
            sheet.SetColumnWidths("D", 90);

            sheet.Calculate();
            Console.WriteLine("Total: " + sheet.Text("D5"));
            sheet.SaveToFile("sales.xlsx");
        }
    }
}

파일에는 수식과 계산된 값이 함께 저장돼요. Text는 숫자 서식을 적용해 인쇄되는 모습 그대로 셀을 반환해요. C# 클래스는 Delphi 에디션의 이름을 그대로 써요. Values['A1'] 같은 인덱스 속성은 Values와 SetValues 메서드 쌍이 되고, Formulas, ColumnWidths, RowHeights도 마찬가지예요.

C#에서 XLSX 파일 읽고 업데이트하기

LoadFromFile과 LoadFromStream은 XLSX, ODS, CSV를 값, 수식, 스타일, 병합된 셀, 레이아웃, 페이지 설정, 보호, 차트, XLSX 파일의 조건부 서식과 함께 불러와요. 필요한 부분을 바꾸고, 다시 계산한 다음 저장하세요.

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.LoadFromFile("sales.xlsx");
    Console.WriteLine(sheet.SheetNames(0) + ": " + sheet.UsedRange());
    Console.WriteLine("D2 formula: " + sheet.Formulas("D2"));
    Console.WriteLine("Units of B3: " + sheet.Values("B3"));

    // change a value, calculate again, save and print to PDF
    sheet.SetValues("B3", 5);
    sheet.Calculate();
    Console.WriteLine("New total: " + sheet.Text("D5"));
    sheet.SaveToFile("sales_updated.xlsx");
    Console.WriteLine(sheet.ExportToPDFFile("sales.pdf") + " PDF page(s)");
}

Values는 object를 반환해요. 빈 셀은 null, 날짜는 DateTime, 오류는 #DIV/0! 같은 오류 텍스트예요. Evaluate는 셀에 쓰지 않고 통합 문서를 대상으로 어떤 수식이든 실행해요.

XLSX 파일의 수식, 스타일, 데이터

TsgcDocsSpreadsheet 뒤의 통합 문서 엔진은 관리형 C# 코드예요. 실행하는 컴퓨터에 Excel, COM 상호 운용, 네이티브 라이브러리가 필요 없어요.

Excel 함수 320개

=로 시작하는 텍스트는 수식이에요. 엔진은 LET, LAMBDA, 이름 있는 LAMBDA 함수를 포함해 Excel 함수 320개를 계산하고, DefineName은 VAT 같은 통합 문서 이름이나 재사용 가능한 LAMBDA를 추가해요.

스타일과 숫자 서식

SetFormat은 범위의 글꼴 크기, 굵게, 기울임, 색상, 채우기, 정렬, 줄 바꿈, 숫자 서식, 테두리, 들여쓰기, 회전을 설정해요. MergeCells는 범위를 병합해요.

레이아웃과 시트

열 너비와 행 높이, AddSheet, 시트를 참조하는 수식을 다시 쓰는 RenameSheet, DeleteSheet, 그리고 시트와 통합 문서 보호.

데이터베이스의 데이터

ImportDataSet은 DataTable이나 IDataReader를 시트에 복사하고, 열 캡션이나 필드 이름을 머리글 행으로 쓰며, 행 수를 반환해요.

차트 유지

XLSX 파일을 불러오고 다시 저장해도 서식, 병합된 셀, 차트, 조건부 서식이 유지되고, 시트의 차트도 함께 인쇄돼요.

PDF, HTML, PNG 출력

ExportToPDFFile은 통합 문서의 페이지 설정으로 시트 하나 또는 보이는 모든 시트를 인쇄하고, ExportToHTML은 시트마다 HTML 표를 작성하며, ExportSheetPageToPNG는 인쇄된 페이지 하나를 렌더링해요.

ASP.NET Core와 Linux의 Excel 파일

이 패키지는 Windows, Linux, macOS의 콘솔 프로그램, 서비스, ASP.NET Core, 데스크톱 애플리케이션에서 실행돼요. SaveToStream은 통합 문서를 어떤 스트림에든 쓰므로, 웹 API가 임시 파일 없이 XLSX 파일을 반환할 수 있어요.

using esegece.sgcDocs;

var app = WebApplication.CreateBuilder(args).Build();

// GET /report.xlsx returns a workbook built for the request
app.MapGet("/report.xlsx", () =>
{
    var stream = new MemoryStream();
    using (var sheet = new TsgcDocsSpreadsheet())
    {
        sheet.New();
        sheet.SetValues("A1", "Generated");
        sheet.SetValues("B1", DateTime.Now);
        sheet.SaveToStream(stream, TsgcDocsFormat.dfXLSX);
    }
    stream.Position = 0;
    return Results.File(stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "report.xlsx");
});

app.Run();

컴포넌트는 스레드 안전이 아니에요. 요청에 필요한 컴포넌트는 그 요청을 처리하는 스레드에서 만드세요. 별도의 인스턴스는 병렬로 실행돼요. Linux와 컨테이너에서는 문서에 쓰는 TrueType 글꼴을 설치하거나 AddFontFolder로 글꼴 폴더를 추가하세요. .NET 데모에는 서버에서 문서를 변환하는 ASP.NET Core 최소 API인 ConversionServer가 들어 있어요.

C# DOCX 라이브러리도 돼요: Word와 PDF 파일

같은 패키지가 Word 문서도 만들고 읽어요. TsgcDocsWordProcessor는 DOCX, RTF, HTML, Markdown, 텍스트를 읽고 쓰며, DataTable, CSV, JSON으로 메일 병합을 실행하고, PDF로 내보내요. TsgcDocsConverter는 문서, 스프레드시트, PDF 파일, 이미지 사이를 한 번의 호출로 변환해요.

// a Word document saved as DOCX and PDF
using (var word = new TsgcDocsWordProcessor())
{
    word.New();
    word.Title = "Quarterly report";
    word.AppendParagraph("Quarterly report", "Heading 1");
    word.AppendParagraph("Sales grew 12% in the third quarter.");
    word.SaveToFile("report.docx");
    word.ExportToPDFFile("report.pdf");
    Console.WriteLine("Pages: " + word.PageCount);
}

// one call conversions, the formats come from the file extensions
using (var converter = new TsgcDocsConverter())
{
    converter.Convert("sales.xlsx", "sales.csv");
    converter.Convert("report.docx", "report.html");
}

Word 문서

Word에서 만든 DOCX 템플릿을 ReplaceAll로 채우거나 데이터와 병합하고, 결과를 DOCX나 PDF로 저장하세요.

PDF 처리

TsgcDocsPDFProcessor는 페이지를 병합, 분할, 회전하고, 텍스트를 추출하고, 양식을 채우고, AES-256으로 암호화하고, PDF/A로 변환하고, 서명해요.

바코드와 ZIP

TsgcDocsBarcode는 QR Code, Data Matrix, Code 128 등을 PNG, SVG로 쓰거나 PDF 페이지에 쓰고, TsgcDocsZipArchive는 ZIP64 아카이브를 만들어요.

NuGet에서 C# Excel 라이브러리 설치하기

프로젝트에 esegece.sgcDocs 패키지를 추가하세요. NuGet이 기반이 되는 엔진인 esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet, esegece.sgcCharts를 함께 추가해 줘요.

dotnet add package esegece.sgcDocs

esegece.sgcDocs는 sgcUI .NET Enterprise와 All-Access에 포함되는 Registered 패키지이며 nuget.org에는 게시되지 않아요. 문서와 시트의 PNG, SVG 페이지에는 패키지가 하나 더 필요해요. esegece.sgcUICore.Rendering이에요. 그래서 XLSX, DOCX, PDF 파일만 쓰는 서버는 네이티브 렌더링 라이브러리를 가져가지 않아요.

패키지대상 프레임워크실행 환경
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9, 10Windows, Linux, macOS의 콘솔 프로그램, 서비스, ASP.NET Core, 데스크톱 애플리케이션
esegece.sgcUICore.Rendering필요할 때만 추가해요문서와 시트의 PNG, SVG 페이지

C# Excel 라이브러리가 포함된 곳

sgcDocs는 단독으로 판매하지 않으며 무료 Community 에디션도 없어요. sgcUI .NET Enterprise에는 전체 C# 소스 코드와 1년 업데이트가 포함돼요.

sgcUI .NET Enterprise

sgcDocs를 포함한 .NET용 모든 sgcUI 제품과 WinForms, WPF, Avalonia용 전체 C# 소스 코드가 개발자당 €699부터 제공돼요.

All-Access

sgcUI Enterprise와 sgcDocs를 포함한 모든 eSeGeCe 제품.

All-Access 보기 →

Delphi와 C++ Builder에서도 쓸 수 있어요

Win32, Win64, Linux64의 Delphi 7부터 13까지, C++ Builder 2007부터 13까지에서 같은 클래스 이름의 같은 API를 쓸 수 있어요.

Delphi용 sgcDocs →

자주 묻는 질문

esegece.sgcDocs 패키지를 추가하고, TsgcDocsSpreadsheet를 만들고, New를 호출한 다음, SetValues와 SetFormulas로 셀을 쓰고 SaveToFile("report.xlsx")를 호출하세요. 통합 문서는 관리형 C# 코드가 작성하므로 컴퓨터에 Excel이나 Office를 설치할 필요가 없어요.

네. =로 시작하는 텍스트는 수식이고, 엔진은 파일을 저장하기 전에 Excel 함수 320개를 계산하므로 XLSX에는 수식과 값이 모두 들어 있어요. SetFormat은 범위의 글꼴, 색상, 채우기, 정렬, 줄 바꿈, 테두리, 숫자 서식을 설정하고, SetColumnWidths와 SetRowHeights는 레이아웃 크기를 조정해요.

네, XLSX, ODS, CSV 파일을 읽을 수 있어요. LoadFromFile이나 LoadFromStream이 값, 수식, 스타일, 병합된 셀, 페이지 설정, 보호, 차트를 불러오고, Values, Formulas, Text가 모든 셀을 읽어요. 바이너리 XLS 형식은 지원하지 않아요.

네. 이 패키지는 .NET Standard 2.0, .NET Framework 4.7.2, .NET 6부터 10까지를 대상으로 하고, Windows, Linux, macOS의 콘솔 프로그램, 서비스, ASP.NET Core, 데스크톱 애플리케이션에서 실행돼요. 컴포넌트는 스레드 안전이 아니므로 요청마다 컴포넌트를 하나씩 만들고, 서버에는 문서에 쓰는 TrueType 글꼴을 설치하세요.

네. 같은 패키지의 TsgcDocsWordProcessor가 DOCX, RTF, HTML, Markdown 문서를 만들고, 읽고, 편집하며, 템플릿을 채우고, 메일 병합을 실행하고, PDF로 내보내요. TsgcDocsPDFProcessor는 PDF 파일을 병합, 암호화, PDF/A로 변환, 서명해요.

아니요. sgcDocs에는 무료 Community 에디션이 없어요. .NET 패키지는 Registered 전용이며 sgcUI .NET Enterprise와 All-Access에 포함되고 nuget.org에는 게시되지 않아요. .NET 평가가 필요하면 문의해 주세요.

네. sgcUI .NET Enterprise 라이선스에는 전체 C# 소스 코드와 1년 업데이트가 포함돼요. sgcUI 가격 페이지를 참고하세요.

최고의 가성비: All-Access모든 eSeGeCe 제품과 프리미엄 지원이 포함되어 연 €1,059부터 이용할 수 있어요.
All-Access 가격 보기

C# 코드로 Excel 파일을 만드세요

컴퓨터에 Office 없이 .NET 패키지 하나로 XLSX, DOCX, PDF를 다뤄요.