.NET 向け C# XLSX、ODS、CSV Office 不要

XLSX ファイル向けの C# Excel ライブラリ

sgcDocs は、Office をインストールせずに、Windows、Linux、macOS で、数式、スタイル、数値書式付きの XLSX ファイルを作成、読み取りする C# の Excel ライブラリです。

320 個の Excel 関数を計算 フォント、塗りつぶし、罫線、数値書式 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 相互運用、ネイティブライブラリは不要です。

320 個の Excel 関数

= で始まるテキストは数式です。エンジンは、LET、LAMBDA、名前付き LAMBDA 関数を含む 320 個の Excel 関数を計算し、DefineName は VAT のようなブック名や再利用可能な LAMBDA を追加します。

スタイルと数値書式

SetFormat は、範囲のフォントサイズ、太字、斜体、色、塗りつぶし、配置、折り返し、数値書式、罫線、インデント、回転を設定します。MergeCells は範囲を結合します。

レイアウトとシート

列幅と行の高さ、AddSheet、そのシートを参照する数式を書き換える RenameSheet、DeleteSheet、シートとブックの保護。

データベースのデータ

ImportDataSet は、DataTable または IDataReader をシートにコピーし、列の見出しまたはフィールド名をヘッダー行にして、行数を返します。

グラフを保持

XLSX ファイルを読み込んで再び保存しても、書式、結合セル、グラフ、条件付き書式は保持され、シートのグラフも一緒に印刷されます。

PDF、HTML、PNG への出力

ExportToPDFFile は、ブックのページ設定に従って 1 つのシートまたはすべての表示シートを印刷し、ExportToHTML はシートごとに HTML テーブルを書き出し、ExportSheetPageToPNG は印刷された 1 ページを描画します。

ASP.NET Core と Linux での Excel ファイル

このパッケージは、Windows、Linux、macOS 上のコンソールプログラム、サービス、ASP.NET Core、デスクトップアプリケーションで動作します。SaveToStream はブックを任意のストリームに書き出すため、Web 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 ファイル、画像の間を 1 回の呼び出しで変換します。

// 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 は Registered パッケージで、sgcUI .NET Enterprise と All-Access に含まれ、nuget.org では公開されていません。ドキュメントとシートの PNG と SVG ページには、もう 1 つのパッケージ 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 もインストールする必要はありません。

はい。= で始まるテキストは数式で、エンジンはファイルの保存前に 320 個の Excel 関数を計算するため、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、デスクトップアプリケーションで動作します。コンポーネントはスレッドセーフではないため、リクエストごとに 1 つ作成し、ドキュメントで使う 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-AccesseSeGeCe の全製品にプレミアムサポートが付いて、年間 €1,059 からご利用いただけます。
All-Access の価格を見る

C# コードから Excel ファイルを作成

1 つの .NET パッケージで XLSX、DOCX、PDF を、マシンに Office を入れずに作成できます。