星空最火知名网站

 Excel 作为最常用的数据管理与分析工具之一，被广泛应用于各类数据处理场景。在 C# 应用程序开发过程中，无论是生成业务报表、导出数据库查询结果，还是实现自动化办公流程，C# 写入 Excel 的功能都扮演着至关重要的角色。

借助 Spire.XLS for .NET这一强大的第三方库，开发者无需在运行环境中安装 Microsoft Excel，即可高效、灵活地实现 Excel 文件的创建、写入与导出操作。本文将系统讲解如何 使用 C# 写入 Excel 文件 ，包括不同数据类型的插入方法、批量数据写入技巧、文件保存与导出，助力开发者提升数据处理与自动化能力。

Spire.XLS for .NET试用下载

欢迎加入Spire技术交流Q群（125237868），与更多小伙伴一起提升文档开发技能~

Spire.XLS for .NET 简介与安装

什么是 Spire.XLS for .NET

Spire.XLS for .NET 是由 E-iceblue 开发的一款专业 Excel 库。它允许开发人员在 C# 中写入 Excel 文件，并执行包括创建、编辑、读取和导出 Excel 文档在内的多种操作，而无需安装 Microsoft Excel。

主要功能包括：

• 通过编程写入和更新 Excel 文件
• 支持 Excel 格式（XLS、XLSX、CSV、ODS）
• 提供高级功能，如公式、图表、数据透视表和数据验证
• 将 Excel 导出为 PDF、HTML 和图片格式
• 在处理大型数据集时保持高性能，适用于桌面、服务器和 Web 应用程序

如何安装 Spire.XLS for .NET

方式一：通过 NuGet 安装（推荐）

1. 打开 Visual Studio。
2. 依次选择 工具 > NuGet 包管理器 > 管理解决方案的 NuGet 包...
3. 搜索 Spire.XLS 并安装。

或直接使用包管理器控制台：

PM> Install-Package Spire.XLS

方式二：手动安装

1. 从慧都网下载 Spire.XLS 安装包。
2. 在项目中添加对 Spire.Xls.dll的引用。

安装完成后，你就可以在 C# 中开始写入 Excel 了。

如何在 C# 中创建 Excel 文件

第一步是创建一个新的工作簿并添加工作表，示例如下：

using Spire.Xls;

namespace CreateNewExcel
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建一个新的工作簿
            Workbook workbook = new Workbook();

            // 移除默认工作表
            workbook.Worksheets.Clear();

            // 添加一个工作表
            Worksheet sheet = workbook.Worksheets.Add("报告");

            // 保存空的 Excel 文件
            workbook.SaveToFile("新建文档.xlsx", ExcelVersion.Version2016);
            workbook.Dispose();
        }
    }
}

 此时，你已经成功创建了一个包含名为“报告”的工作表的空 Excel 文件。接下来我们将向其中写入数据。

C# 向 Excel 单元格写入不同数据类型

Spire.XLS 允许你直接将多种数据类型写入 Excel 单元格。常见示例如下：

写入文本

sheet.Range["A1"].Text = "你好 Excel!";

sheet.Range["A2"].NumberValue = 123.45;

sheet.Range["A3"].DateTimeValue = DateTime.Now;
sheet.Range["A3"].NumberFormat = "yyyy-mm-dd hh:mm";

sheet.Range["A4"].BooleanValue = true;

sheet.Range["A5"].TimeSpanValue = new TimeSpan(2, 30, 0);
sheet.Range["A5"].NumberFormat = "[h]:mm:ss";

sheet.Range["A6"].Formula = "=SUM(A2,100)";

string htmlText = "<span style=\"font-family: Times New Roman; color: blue; font-size: 15pt;\">HTML <strong>格式文本</strong></span>";
sheet.Range["A7"].HtmlString = htmlText;

sheet.Range["A8"].Value = "一般数据";

C# 将批量数据写入 Excel 工作表

处理大型数据集时，逐个单元格写入效率很低。Spire.XLS 提供了直接插入数组和 DataTable 的方法，其他数据结构可以先转换为数组或 DataTable。

写入数组到 Excel

使用 Worksheet.InsertArray方法，可以将一维或二维数组写入指定区域：

string[,] data = {
    { "姓名", "年龄", "国家" },
    { "张三", "30", "中国" },
    { "李四", "28", "中国" },
    { "王五", "35", "加拿大" }
};

sheet.InsertArray(data, 1, 1);

写入 DataTable 到 Excel

使用 InsertDataTable方法将 DataTable 数据导入到工作表：

DataTable dt = new DataTable();
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("产品", typeof(string));
dt.Columns.Add("价格", typeof(double));

dt.Rows.Add(1, "笔记本电脑", 8999);
dt.Rows.Add(2, "平板电脑", 5999);
dt.Rows.Add(3, "手机", 6999);

sheet.InsertDataTable(dt, true, 1, 1, true);

写入 List 到 Excel

虽然 Spire.XLS 没有直接支持写入 List 的方法，但你可以先将 List 转换为 DataTable，再写入 Excel。

using Spire.Xls;
using System.Data;

namespace WriteListToExcel
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建一个工作簿实例
            Workbook workbook = new Workbook();

            // 移除默认工作表
            workbook.Worksheets.Clear();

            // 添加一个工作表并命名
            Worksheet worksheet = workbook.Worksheets.Add("成绩单");

            // 创建一个学生数据列表
            List<Student> students = new List<Student>
            {
                new Student("迈克尔", "约翰逊", 20, "计算机科学", 3.8),
                new Student("莎拉", "威廉姆斯", 22, "数学", 3.6),
                new Student("杰西卡", "布朗", 19, "物理", 3.9),
                new Student("大卫", "史密斯", 21, "化学", 3.7),
                new Student("艾米莉", "戴维斯", 23, "生物", 3.5)
            };

            // 将列表转换为数据表
            DataTable dataTable = ConvertListToDataTable(students);

            // 将数据表写入工作表
            worksheet.InsertDataTable(dataTable, true, 1, 1, true);

            // 设置列宽
            worksheet.AllocatedRange.ColumnWidth = 12;

            // 内容左对齐
            worksheet.AllocatedRange.HorizontalAlignment = HorizontalAlignType.Left;

            // 保存为Excel文件
            workbook.SaveToFile("学生成绩单.xlsx", ExcelVersion.Version2016);

            // 释放资源
            workbook.Dispose();
        }

        static DataTable ConvertListToDataTable(List<Student> students)
        {
            DataTable dataTable = new DataTable();

            // 添加列
            dataTable.Columns.Add("名字", typeof(string));
            dataTable.Columns.Add("姓氏", typeof(string));
            dataTable.Columns.Add("年龄", typeof(int));
            dataTable.Columns.Add("专业", typeof(string));
            dataTable.Columns.Add("绩点", typeof(double));

            // 添加行
            foreach (var student in students)
            {
                DataRow row = dataTable.NewRow();
                row["名字"] = student.FirstName;
                row["姓氏"] = student.LastName;
                row["年龄"] = student.Age;
                row["专业"] = student.Major;
                row["绩点"] = student.GPA;
                dataTable.Rows.Add(row);
            }

            return dataTable;
        }
    }

    class Student
    {
        public string FirstName { get; set; }
        public string LastName { get; set; }
        public int Age { get; set; }
        public string Major { get; set; }
        public double GPA { get; set; }

        public Student(string firstName, string lastName, int age, string major, double gpa)
        {
            FirstName = firstName;
            LastName = lastName;
            Age = age;
            Major = major;
            GPA = gpa;
        }
    }
}

保存和导出 Excel 文件

写入数据后，你需要保存或导出 Excel 文件。Spire.XLS 支持多种格式（XLSX、CSV、PDF 等）：

// 保存为 XLSX
workbook.SaveToFile("Output.xlsx", ExcelVersion.Version2016);

// 保存为 CSV
workbook.SaveToFile("Output.csv", ",", Encoding.UTF8);

// 导出为 PDF
workbook.SaveToFile("Output.pdf", FileFormat.PDF);

using (MemoryStream ms = new MemoryStream())
{
    workbook.SaveToStream(ms, FileFormat.Version2016);
    // 可写入到 ASP.NET Response
}

常见问题与解决方案

1. 日期/时间格式错误

   • 问题：日期/时间显示为序列号。
   • 解决办法：设置正确的单元格格式。

2. 数据覆盖或错位

   • 问题：数组或 DataTable 写入时覆盖现有数据。
   • 解决办法：检查 InsertArray/InsertDataTable 的起始行列参数。

3. 大数据集写入性能低

   • 问题：数千行写入速度慢。
   • 解决办法：使用批量写入方法，避免逐单元格写入。

4. 公式未正确计算

   • 问题：写入的公式未返回预期结果。
   • 解决办法：检查公式语法，必要时调用 workbook.CalculateAllValue()。

总结

在 C# 中实现 Excel 写入功能既直观又高效。借助 Spire.XLS for .NET，无论是写入单个数值、文本、日期，还是处理大规模结构化数据集，都能轻松胜任。该库不仅支持单元格样式、公式计算、条件格式等高级功能，还能精准控制输出效果，确保最终生成的 Excel 文件数据准确、外观专业。

通过数组或 DataTable 进行批量数据写入，可大幅提升数据输出效率，灵活应对不同体量的数据导出需求。若你正在寻找一种稳定、高效且无需依赖 Microsoft Excel 环境的文件生成方案，Spire.XLS for .NET 无疑是一个理想的技术选择。

常见问答（FAQs）

Q1. 我能用 Spire.XLS 写入已有的 Excel 文件吗？

 可以。使用 workbook.LoadFromFile("file.xlsx") 打开文件，然后修改并保存。

Q2. Spire.XLS 是否需要安装 Microsoft Excel？

不需要，它是一个独立库。

Q3. Spire.XLS 能处理包含成千上万行的大文件吗？

可以，它针对大数据集做了性能优化。

Q4. 写入数据时如何设置单元格样式？

 你可以通过以下方式设置字体、颜色、边框和对齐方式：

sheet.Range["A1"].Style.Font.IsBold = true;
sheet.Range["A1"].Style.Color = Color.Yellow;
sheet.Range["A1"].Style.HorizontalAlignment = HorizontalAlignType.Left;

欢迎下载|体验更多E-iceblue产品

————————————————————————————————————————

关于慧都科技：

慧都科技是一家行业数字化解决方案公司，长期专注于软件、油气与制造行业。公司基于深入的业务理解与管理洞察，以系统化的业务建模驱动技术落地，帮助企业实现智能化运营与长期竞争优势。在软件工程领域，我们提供开发控件、研发管理、代码开发、部署运维等软件开发全链路所需的产品，提供正版授权采购、技术选型、个性化维保等服务，帮助客户实现技术合规、降本增效与风险可控。慧都科技E-iceblue的官方授权代理商，提供E-iceblue系列产品免费试用，咨询，正版销售等于一体的专业化服务。E-iceblue旗下Spire系列产品是国产文档处理领域的优秀产品，支持国产化，帮助企业高效构建文档处理的应用程序。