已更新 2026年6月28日
using Microsoft Office Interop Excel C# 读取 Excel 文件：以及一种无需 Office 即可更快创建 Excel 文件的方法
using Microsoft Office Interop Excel 在 C# 中读取 Excel 文件，然后切换到 IronXL 以创建服务器安全、跨平台的 Excel 文件，而无需依赖 Office。
阅读更多
USING IRONXL
如何使用IronXL在 C# 中将数据导出到现有的 Excel 模板
Curtis Chau
Updated: 2026年6月28日
using Microsoft Excel 模板，您可以在动态填充数据的同时保留格式、公式和布局。 本教程演示了如何使用 IronXL 将数据导出到现有的 Excel 工作表模板中——无需依赖 Microsoft Office 或 Excel Interop。您将学习如何加载预设模板、替换占位符、写入表格数据、处理常见边界情况，并在任何 .NET 10 应用程序中保存专业的 XLSX 输出文件。
如果您需要在未安装 Microsoft Office 的情况下将数据导出到现有的 Excel 模板中，IronXL 提供了一种高性能的解决方案，支持从字典、列表、DataTable 对象以及数据库查询结果中插入数据。 无论您的模板是格式化的发票、月度仪表盘还是合规报告，IronXL 都能通过编程方式自动填充内容，并在过程中完整保留每项样式规则、公式和条件格式。
为什么 Excel 模板能提升报表生成效率？
与从头开始制作电子表格相比，Excel 模板具有显著优势。 模板保持专业格式、复杂公式、条件格式规则和组织已批准的数据结构。 财务团队、运营部门和合规小组通常有用于发票、仪表板和监管文件的标准化模板，这些模板必须保留其设计，同时将新数据从数据库、API或内存集合中加入其中。
通过编程方式填充现有模板，您可以节省数小时的格式化工作，并确保每份生成的文档保持一致性。 IronXL 支持 XLSX、XLS、XLSM 和 XLTX 格式，且无需安装 Office，因此非常适合在无法或不宜安装 Microsoft Office 的服务器环境、Docker 容器及云管道中使用。
基于模板的方法的主要优势：
- 公式保留——写入数据后，现有的 SUM、AVERAGE 和查找公式会自动重新计算
- 样式保留 -- 字体、边框、单元格颜色和数字格式完全按设计保持
- 条件格式化 -- 与单元格范围关联的规则会根据新数据值继续生效
- 完全脱离 Office 依赖——IronXL 完全通过托管 .NET 代码读写 Excel 文件
- 跨平台支持——可在 Windows、Linux 和 macOS 上运行，包括 .NET 10 环境
如何在项目中安装 IronXL？
首先通过 NuGet 安装 IronXL。 打开软件包管理器控制台并运行：
或使用 .NET CLI：
IronXL 可独立运行，无需安装 Microsoft Office，因此非常适合服务器环境和跨平台应用程序。 如需详细的设置说明，请访问 IronXL 入门指南。 该库支持 .NET Framework、.NET Core 以及 .NET 5 至 .NET 10，可在 Windows、Linux 和 macOS 系统上运行。
安装完成后，请在文件开头添加命名空间：
using IronXL;Imports IronXL
如何加载并填充现有的 Excel 模板？
using 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");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 示例页面，探索更多模式。
输入
输出
如何在模板中替换占位符？
许多模板使用占位符文本标记——例如，{{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");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单元格样式指南，其中包括背景颜色、字体属性和边框样式。
如何选择适合迭代的单元格范围？
在迭代查找占位符时，请选择一个范围，既要覆盖所有包含标记的单元格，又避免范围过大。 像"A1:H50"这样的范围对于大多数发票模板来说都很高效。 对于数据分布在数百行中的模板，请将迭代范围限制在表头部分，并对数据主体使用直接单元格引用。 这确保了即使在大型工作簿中，性能也能保持可预测性。
如何处理缺失或不匹配的占位符？
在调用.Replace()之前添加一个空或为null的检查，以避免在模板版本不同时发生异常。 您可以记录未解决的占位符以便调试：
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);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文档。
输入
输出
如何排查常见的模板错误？
在使用模板时，经常会出现一些问题。 下表列出了各项症状及其原因和解决方法：
| 症状 | 可能原因 | 解决方案 |
|---|---|---|
| 加载时发生 FileNotFoundException | 文件路径或工作目录错误 | 使用 Path.Combine(AppContext.BaseDirectory, "template.xlsx") 确保路径准确 |
| 显示过期值的公式 | 写入后未触发自动计算 | 在保存前调用 sheet.Calculate() |
| 受密码保护的模板无法打开 | 模板设有工作簿或工作表密码 | 输入密码：WorkBook.Load("template.xlsx", "password") |
| 处理大数据时内存占用较高 | 写入期间将整个工作簿保存在内存中 | 使用 workbook.SaveAs() 配合流式处理，并在保存后释放工作簿 |
| 写入后单元格格式丢失 | 直接覆盖单元格样式对象 | 仅设置 Value/Formula —— 避免替换整个 Style 对象 |
| 图表数据未更新 | 超出图表源范围的书写 | 确保数据行位于为图表提供数据的命名范围或表内 |
对于密码保护的文件，提供密码作为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 以便分发，不需要 Excel
- 导出到 CSV -- 将工作表数据保存为逗号分隔值以进行下游处理
这些功能与模板填充功能集成，因此通过单一工作流即可在一次操作中加载模板、填充数据、保护敏感公式单元格，并同时导出 XLSX 文件和 PDF 版本。
IronXL 还与其他数据交换格式（如 XML）具有良好的兼容性，允许您导入结构化数据、对其进行转换，并将结果导出到模板中。 如需了解与数据库驱动的报表生成进行更高级集成的方法，请参阅 IronXL 博客上的社区教程。
如何在生产环境中开始使用 IronXL？
IronXL 可免费用于开发和测试。 准备部署时，可从涵盖个人开发者、团队及 OEM 再分发的灵活许可选项中进行选择。 请访问 IronXL 许可页面，选择适合您项目的方案。
若需立即开始，请下载免费试用版，并使用本教程中的代码示例配合您自己的模板进行测试。 IronXL 的 NuGet 页面提供了版本历史和包详情。 社区讨论及更多示例可在 Iron Software 的 GitHub 仓库中查阅。 有关支撑 XLSX 文件的 Open XML 文件格式的背景信息，请参阅 ECMA-376 规范概述。
对于同时评估IronXL及其替代方案的组织，IronXL比较指南涵盖功能差异、许可模式和性能基准，以帮助您做出明智的决策。
技术作家
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
...
阅读更多相关文章
已更新 2026年7月19日
在.NET C# 中下载 Excel 文件：将数据导出为 XLSX、CSV 等格式
using C# 和IronXL在ASP.NET Core中下载 Excel 文件。从 MVC 控制器导出数据到 XLSX、CSV 和 XML 格式，并返回 MemoryStream 和 File() 函数。包含代码示例。
阅读更多
已更新 2026年6月28日
如何在不使用互操作的情况下，使用 C# 在 Excel 中创建数据透视表
学习如何使用 C# 在 Excel 中创建数据透视表，无需依赖 Office 套件。本指南涵盖 Excel Interop 和IronXL ，并提供完整的代码示例。
阅读更多
您需要的 Excel API，无需 Office Interop 烦恼。
