IronXLを使用して C# で既存の Excel テンプレートにデータをエクスポートする方法

Excelテンプレートはなぜレポート作成を改善するのか？

Excelテンプレートは、スプレッドシートをゼロから作成するよりも大きな利点があります。 テンプレートは、プロフェッショナルな書式、複雑な数式、条件付き書式ルール、および組織が承認済みの検証済みデータ構造を維持します。 財務チーム、運用部門、およびコンプライアンスグループは、新しいデータをデータベース、API、またはインメモリコレクションから取り入れつつ、そのデザインを保持するために、請求書、ダッシュボード、および規制に関する提出物の標準化されたテンプレートを持っていることがよくあります。

既存のテンプレートにプログラムで自動的に入力することで、書式設定作業にかかる時間を大幅に節約でき、生成されるすべての文書の一貫性を保証できます。 IronXLは、Officeのインストールを必要とせずにXLSX、XLS、XLSM、XLTX形式をサポートしているため、Microsoft Officeのインストールが非現実的または不可能なサーバー環境、Dockerコンテナ、クラウドパイプラインに適しています。

テンプレートベースのアプローチの主な利点：

-数式の保持-- 既存のSUM、AVERAGE、およびルックアップ数式は、データ書き込み後に自動的に再計算されます。

• スタイル保持 -- フォント、境界線、セルの色、数値のフォーマットは設計通りにそのまま残ります。 -条件付き書式設定- セル範囲に関連付けられたルールは、新しいデータ値に基づいて引き続き実行されます
• Officeへの依存なし-- IronXLはExcelファイルの読み書きをすべてマネージド.NETコードで行います -クロスプラットフォーム対応- Windows、Linux、macOS、および.NET 10環境で動作します

プロジェクトにIronXLをインストールするにはどうすればよいですか？

まず、 NuGetを使ってIronXL をインストールしてください。 パッケージマネージャーコンソールを開いて次を実行します：

Install-Package IronXL.Excel

または.NET CLIを使用します：

dotnet add package IronXL.Excel

IronXLはMicrosoft Officeのインストールを必要とせず独立して動作するため、サーバー環境やクロスプラットフォームアプリケーションに最適です。 詳しい設定手順については、 IronXLの入門ガイドをご覧ください。 このライブラリは、Windows、Linux、macOS上で動作する.NET Framework、 .NET Core、および.NET 5から.NET 10を対象としています。

インストール後、ファイルの先頭に名前空間を追加してください。

using IronXL;

using IronXL;

Imports IronXL

既存のExcelテンプレートを読み込んでデータを入力するにはどうすればよいですか？

IronXLのWorkBook.Load()メソッドを使えば、既存のテンプレートを簡単に読み込むことができます。 以下の例では、四半期売上レポートのテンプレートを開き、トップレベルのステートメントを使用して特定のセルにデータを入力します。

using IronXL;

// Load the existing Excel template
WorkBook workbook = WorkBook.Load("ReportTemplate.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Write header values to named cells
sheet["B2"].Value = "Q4 2025 Sales Report";
sheet["C4"].StringValue = DateTime.Now.ToString("MMMM dd, yyyy");
sheet["C6"].DecimalValue = 125000.50m;
sheet["C7"].DecimalValue = 98500.75m;

// Add a profit formula -- Excel recalculates automatically
sheet["C8"].Formula = "=C6-C7";

// Populate a column range with monthly data
decimal[] monthlyData = { 10500, 12300, 15600, 11200 };
for (int i = 0; i < monthlyData.Length; i++)
{
    sheet[$"E{10 + i}"].DecimalValue = monthlyData[i];
}

// Save the populated file
workbook.SaveAs("Q4_Sales_Report.xlsx");

using IronXL;

// Load the existing Excel template
WorkBook workbook = WorkBook.Load("ReportTemplate.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Write header values to named cells
sheet["B2"].Value = "Q4 2025 Sales Report";
sheet["C4"].StringValue = DateTime.Now.ToString("MMMM dd, yyyy");
sheet["C6"].DecimalValue = 125000.50m;
sheet["C7"].DecimalValue = 98500.75m;

// Add a profit formula -- Excel recalculates automatically
sheet["C8"].Formula = "=C6-C7";

// Populate a column range with monthly data
decimal[] monthlyData = { 10500, 12300, 15600, 11200 };
for (int i = 0; i < monthlyData.Length; i++)
{
    sheet[$"E{10 + i}"].DecimalValue = monthlyData[i];
}

// Save the populated file
workbook.SaveAs("Q4_Sales_Report.xlsx");

Imports IronXL

' Load the existing Excel template
Dim workbook As WorkBook = WorkBook.Load("ReportTemplate.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' Write header values to named cells
sheet("B2").Value = "Q4 2025 Sales Report"
sheet("C4").StringValue = DateTime.Now.ToString("MMMM dd, yyyy")
sheet("C6").DecimalValue = 125000.50D
sheet("C7").DecimalValue = 98500.75D

' Add a profit formula -- Excel recalculates automatically
sheet("C8").Formula = "=C6-C7"

' Populate a column range with monthly data
Dim monthlyData As Decimal() = {10500D, 12300D, 15600D, 11200D}
For i As Integer = 0 To monthlyData.Length - 1
    sheet($"E{10 + i}").DecimalValue = monthlyData(i)
Next

' Save the populated file
workbook.SaveAs("Q4_Sales_Report.xlsx")

このコードは、あらかじめデザインされたテンプレートを読み込み、既存の書式設定をすべて維持し、特定のセルにデータを入力します。 DecimalValueプロパティは、数値データが適切な通貨形式または小数点形式を保持することを保証します。 数式セルは隣接するデータが変更されると自動的に再計算されるため、テンプレートの計算ロジックはそのまま維持されます。

Excelのセル参照とセル範囲の操作方法については、 IronXLのセルとセル範囲に関するドキュメントを参照してください。 IronXLのサンプルページを利用して、その他のパタ​​ーンも確認することもできます。

テンプレート内のプレースホルダーマーカーを置き換えるにはどうすればよいですか？

多くのテンプレートはプレースホルダーテキストマーカーを使用しています。例えば、{{CustomerName}} または {{InvoiceDate}} 。これらは実際のランタイム値に置き換える必要があります。 IronXLは、定義された範囲でセルを反復処理することでこれを処理します。 このパターンは、請求書の生成、契約の作成、個別化されたレポートの作成に特に有用です。

using IronXL;

// Load an invoice template containing placeholder markers
WorkBook workbook = WorkBook.Load("InvoiceTemplate.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Iterate over a range and replace placeholder text
foreach (var cell in sheet["A1:H50"])
{
    if (cell.Text.Contains("{{CustomerName}}"))
        cell.Value = cell.Text.Replace("{{CustomerName}}", "Acme Corporation");

    if (cell.Text.Contains("{{InvoiceDate}}"))
        cell.Value = cell.Text.Replace("{{InvoiceDate}}", DateTime.Now.ToShortDateString());

    if (cell.Text.Contains("{{InvoiceNumber}}"))
        cell.Value = cell.Text.Replace("{{InvoiceNumber}}", "INV-2025-001");
}

// Append line items starting at row 15
var items = new[]
{
    new { Description = "Software License", Qty = 5, Price = 299.99 },
    new { Description = "Support Package",  Qty = 1, Price = 999.99 }
};

int startRow = 15;
foreach (var item in items)
{
    sheet[$"B{startRow}"].Value      = item.Description;
    sheet[$"E{startRow}"].IntValue   = item.Qty;
    sheet[$"F{startRow}"].DoubleValue = item.Price;
    sheet[$"G{startRow}"].Formula    = $"=E{startRow}*F{startRow}";
    startRow++;
}

workbook.SaveAs("GeneratedInvoice.xlsx");

using IronXL;

// Load an invoice template containing placeholder markers
WorkBook workbook = WorkBook.Load("InvoiceTemplate.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Iterate over a range and replace placeholder text
foreach (var cell in sheet["A1:H50"])
{
    if (cell.Text.Contains("{{CustomerName}}"))
        cell.Value = cell.Text.Replace("{{CustomerName}}", "Acme Corporation");

    if (cell.Text.Contains("{{InvoiceDate}}"))
        cell.Value = cell.Text.Replace("{{InvoiceDate}}", DateTime.Now.ToShortDateString());

    if (cell.Text.Contains("{{InvoiceNumber}}"))
        cell.Value = cell.Text.Replace("{{InvoiceNumber}}", "INV-2025-001");
}

// Append line items starting at row 15
var items = new[]
{
    new { Description = "Software License", Qty = 5, Price = 299.99 },
    new { Description = "Support Package",  Qty = 1, Price = 999.99 }
};

int startRow = 15;
foreach (var item in items)
{
    sheet[$"B{startRow}"].Value      = item.Description;
    sheet[$"E{startRow}"].IntValue   = item.Qty;
    sheet[$"F{startRow}"].DoubleValue = item.Price;
    sheet[$"G{startRow}"].Formula    = $"=E{startRow}*F{startRow}";
    startRow++;
}

workbook.SaveAs("GeneratedInvoice.xlsx");

Imports IronXL

' Load an invoice template containing placeholder markers
Dim workbook As WorkBook = WorkBook.Load("InvoiceTemplate.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' Iterate over a range and replace placeholder text
For Each cell In sheet("A1:H50")
    If cell.Text.Contains("{{CustomerName}}") Then
        cell.Value = cell.Text.Replace("{{CustomerName}}", "Acme Corporation")
    End If

    If cell.Text.Contains("{{InvoiceDate}}") Then
        cell.Value = cell.Text.Replace("{{InvoiceDate}}", DateTime.Now.ToShortDateString())
    End If

    If cell.Text.Contains("{{InvoiceNumber}}") Then
        cell.Value = cell.Text.Replace("{{InvoiceNumber}}", "INV-2025-001")
    End If
Next

' Append line items starting at row 15
Dim items = {
    New With {.Description = "Software License", .Qty = 5, .Price = 299.99},
    New With {.Description = "Support Package", .Qty = 1, .Price = 999.99}
}

Dim startRow As Integer = 15
For Each item In items
    sheet($"B{startRow}").Value = item.Description
    sheet($"E{startRow}").IntValue = item.Qty
    sheet($"F{startRow}").DoubleValue = item.Price
    sheet($"G{startRow}").Formula = $"=E{startRow}*F{startRow}"
    startRow += 1
Next

workbook.SaveAs("GeneratedInvoice.xlsx")

この手法では、定義されたセル範囲内のマーカーを検索し、実際の値に置き換えます。 テンプレートのフォーマッティング—フォント、色、境界線、数値フォーマット—は常にそのまま残ります。 実行時により高度なスタイリング変更については、背景色、フォントプロパティ、および境界スタイルをカバーするIronXLセルスタイリングガイドをご覧ください。

using IronXL;

WorkBook workbook = WorkBook.Load("InvoiceTemplate.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

var replacements = new Dictionary<string, string>
{
    { "{{CustomerName}}", "Acme Corporation" },
    { "{{InvoiceDate}}", DateTime.Now.ToShortDateString() },
    { "{{InvoiceNumber}}", "INV-2025-002" }
};

foreach (var cell in sheet["A1:H50"])
{
    if (string.IsNullOrEmpty(cell.Text)) continue;

    foreach (var replacement in replacements)
    {
        if (cell.Text.Contains(replacement.Key))
            cell.Value = cell.Text.Replace(replacement.Key, replacement.Value);
    }
}

workbook.SaveAs("GeneratedInvoice_Safe.xlsx");

using IronXL;

WorkBook workbook = WorkBook.Load("InvoiceTemplate.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

var replacements = new Dictionary<string, string>
{
    { "{{CustomerName}}", "Acme Corporation" },
    { "{{InvoiceDate}}", DateTime.Now.ToShortDateString() },
    { "{{InvoiceNumber}}", "INV-2025-002" }
};

foreach (var cell in sheet["A1:H50"])
{
    if (string.IsNullOrEmpty(cell.Text)) continue;

    foreach (var replacement in replacements)
    {
        if (cell.Text.Contains(replacement.Key))
            cell.Value = cell.Text.Replace(replacement.Key, replacement.Value);
    }
}

workbook.SaveAs("GeneratedInvoice_Safe.xlsx");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("InvoiceTemplate.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

Dim replacements As New Dictionary(Of String, String) From {
    {"{{CustomerName}}", "Acme Corporation"},
    {"{{InvoiceDate}}", DateTime.Now.ToShortDateString()},
    {"{{InvoiceNumber}}", "INV-2025-002"}
}

For Each cell In sheet("A1:H50")
    If String.IsNullOrEmpty(cell.Text) Then Continue For

    For Each replacement In replacements
        If cell.Text.Contains(replacement.Key) Then
            cell.Value = cell.Text.Replace(replacement.Key, replacement.Value)
        End If
    Next
Next

workbook.SaveAs("GeneratedInvoice_Safe.xlsx")

テンプレートから月次レポートを作成するにはどうすればよいですか？

以下は、あらかじめ書式設定されたセル、グラフ、およびパーセンテージ計算式を含む既存のExcelテンプレートから月次売上レポートを生成する実際の例です。 このコードはトップレベルのステートメントを使用し、製品と売上のマッピングを格納した辞書を受け取ります。

using IronXL;

// Load the monthly report template
WorkBook workbook = WorkBook.Load("MonthlyReportTemplate.xlsx");
WorkSheet sheet = workbook.GetWorkSheet("Monthly Report");

// Build sample sales data
var salesData = new Dictionary<string, decimal>
{
    { "Product A", 42500.00m },
    { "Product B", 31750.50m },
    { "Product C", 18300.25m }
};

// Write report header
sheet["B2"].Value = $"Sales Report - {DateTime.Now:MMMM yyyy}";
sheet["B3"].Value = $"Generated: {DateTime.Now:g}";

// Write each product row starting at row 6
int currentRow = 6;
decimal totalSales = salesData.Values.Sum();

foreach (var sale in salesData)
{
    sheet[$"B{currentRow}"].Value = sale.Key;
    sheet[$"C{currentRow}"].DecimalValue = sale.Value;
    // Percentage of total formula
    sheet[$"D{currentRow}"].Formula = $"=C{currentRow}/C{currentRow + salesData.Count}*100";
    currentRow++;
}

// Write the total row and apply bold style
sheet[$"C{currentRow}"].DecimalValue = totalSales;
sheet[$"C{currentRow}"].Style.Font.Bold = true;

// Save with a date-stamped filename
string outputPath = $"Reports/Monthly_Report_{DateTime.Now:yyyyMMdd}.xlsx";
workbook.SaveAs(outputPath);

using IronXL;

// Load the monthly report template
WorkBook workbook = WorkBook.Load("MonthlyReportTemplate.xlsx");
WorkSheet sheet = workbook.GetWorkSheet("Monthly Report");

// Build sample sales data
var salesData = new Dictionary<string, decimal>
{
    { "Product A", 42500.00m },
    { "Product B", 31750.50m },
    { "Product C", 18300.25m }
};

// Write report header
sheet["B2"].Value = $"Sales Report - {DateTime.Now:MMMM yyyy}";
sheet["B3"].Value = $"Generated: {DateTime.Now:g}";

// Write each product row starting at row 6
int currentRow = 6;
decimal totalSales = salesData.Values.Sum();

foreach (var sale in salesData)
{
    sheet[$"B{currentRow}"].Value = sale.Key;
    sheet[$"C{currentRow}"].DecimalValue = sale.Value;
    // Percentage of total formula
    sheet[$"D{currentRow}"].Formula = $"=C{currentRow}/C{currentRow + salesData.Count}*100";
    currentRow++;
}

// Write the total row and apply bold style
sheet[$"C{currentRow}"].DecimalValue = totalSales;
sheet[$"C{currentRow}"].Style.Font.Bold = true;

// Save with a date-stamped filename
string outputPath = $"Reports/Monthly_Report_{DateTime.Now:yyyyMMdd}.xlsx";
workbook.SaveAs(outputPath);

Imports IronXL

' Load the monthly report template
Dim workbook As WorkBook = WorkBook.Load("MonthlyReportTemplate.xlsx")
Dim sheet As WorkSheet = workbook.GetWorkSheet("Monthly Report")

' Build sample sales data
Dim salesData As New Dictionary(Of String, Decimal) From {
    {"Product A", 42500.0D},
    {"Product B", 31750.5D},
    {"Product C", 18300.25D}
}

' Write report header
sheet("B2").Value = $"Sales Report - {DateTime.Now:MMMM yyyy}"
sheet("B3").Value = $"Generated: {DateTime.Now:g}"

' Write each product row starting at row 6
Dim currentRow As Integer = 6
Dim totalSales As Decimal = salesData.Values.Sum()

For Each sale In salesData
    sheet($"B{currentRow}").Value = sale.Key
    sheet($"C{currentRow}").DecimalValue = sale.Value
    ' Percentage of total formula
    sheet($"D{currentRow}").Formula = $"=C{currentRow}/C{currentRow + salesData.Count}*100"
    currentRow += 1
Next

' Write the total row and apply bold style
sheet($"C{currentRow}").DecimalValue = totalSales
sheet($"C{currentRow}").Style.Font.Bold = True

' Save with a date-stamped filename
Dim outputPath As String = $"Reports/Monthly_Report_{DateTime.Now:yyyyMMdd}.xlsx"
workbook.SaveAs(outputPath)

このメソッドは標準化されたテンプレートを形成し、自動的に割合の寄与を計算し、テンプレートのプロフェッショナルな外観を保持します。 テンプレート内の既存のグラフは、データソースの範囲が変更されないため、新しいデータ値に基づいて更新されます。

DataSetからデータを転送する際は、列名を保持し、最初の行をヘッダーとして扱ってください。 DataTableオブジェクトからのインポートについては、IronXL DataTableドキュメントをご覧ください。

よくあるテンプレートエラーのトラブルシューティング方法を教えてください

テンプレートを使用する際には、いくつかの問題が頻繁に発生します。 以下の表は、各症状とその原因および解決策を示しています。

パスワード保護されたファイルの場合、パスワードを第二引数としてWorkBook.Loadに提供してください。 データ書き込み後に数式が更新されない場合、sheet.Calculate()を呼び出してください。 大規模なデータセットの場合は、保存後にワークブックオブジェクトを破棄して、マネージドメモリとアンマネージドメモリを速やかに解放してください。

トラブルシューティングに関するその他のリソースは、 IronXLのトラブルシューティングドキュメントおよびIronXL APIリファレンスに記載されています。

IronXLは他にどのようなExcel操作をサポートしていますか？

テンプレートへのデータ入力に加え、 IronXLは上記ワークフローを補完する幅広いExcel操作機能を提供します。

• Excelファイルを読む -- 既存のワークブックからC#オブジェクト、リスト、またはDataTableにデータを抽出する
• ゼロからExcelファイルを作成する -- テンプレートが不要で完全なレイアウト制御が必要なときに新しいワークブックを生成する
• DataTableをExcelにエクスポートする -- ADO.NET DataTableオブジェクトをワークシートの行に直接変換する
• セルスタイルを適用する -- 背景色、フォントの太さ、境界線、数値のフォーマットをプログラムで設定する
• Excel数式を扱う -- SUM、VLOOKUP、条件付き数式を含む数式文字列を書いて評価する
• セルの結合 -- ヘッダーおよびレポートレイアウトのためにセル範囲を結合および解除する
• ワークシートを保護する -- テンプレート構造の誤っての編集を防ぐためにセルやシートをロックする
• PDFに変換する -- エクセルなしで配布のために埋められたテンプレートをPDFに直接レンダリングする
• CSVにエクスポートする -- 下流の処理のためにカンマ区切り値としてワークシートデータを保存する

これらの機能はテンプレートへのデータ入力と連携して動作するため、単一のワークフローでテンプレートの読み込み、データ入力、機密性の高い数式セルの保護、そしてXLSXファイルとPDFファイルの両方のエクスポートを一度に行うことができます。

IronXLはXMLなどの他のデータ交換フォーマットともスムーズに連携するため、構造化データをインポート、変換し、結果をテンプレートとしてエクスポートすることが可能です。 データベース駆動型レポート生成とのより高度な連携については、 IronXLブログのコミュニティチュートリアルを参照してください。

IronXLを本番環境で使い始めるにはどうすればよいですか？

IronXLは開発およびテスト目的では無料で利用できます。 導入準備が整ったら、個人開発者、チーム、OEM再配布に対応した柔軟なライセンスオプションからお選びください。 プロジェクトに最適なオプションを見つけるには、 IronXLのライセンスページをご覧ください。

すぐに始めるには、無料トライアル版をダウンロードして、このチュートリアルのコード例を自分のテンプレートに対して実行してみてください。 IronXLのNuGetページには、バージョン履歴とパッケージの詳細が記載されています。 コミュニティでの議論やその他の事例は、 Iron SoftwareのGitHubリポジトリでご覧いただけます。 XLSXファイルの基盤となるOpen XMLファイル形式に関する背景情報については、 ECMA-376仕様の概要を参照してください。

IronXLを他の選択肢と一緒に評価している組織のために、IronXL比較ガイドでは、機能の違い、ライセンスモデル、パフォーマンスベンチマークをカバーしており、情報に基づいた決定を行うのに役立ちます。