一聚教程网:一个值得你收藏的教程网站

最新下载

热门教程

C#实现方式高效读取Word表格数据并导出为CSV/TXT实用指南

时间:2026-09-08 14:40:01 编辑:袖梨 来源:一聚教程网

平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“C#实现方法高效读取Word表格数据并导出为CSV/TXT”来说,它看着像小点,放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序,把思路、关键写法和容易踩坑的地方讲清楚,便于大家直接对照操作。

前言

在.NET开发场景中,读取 Word 文档中的表格数据从实现思路看,是办公自动化、数据导入、报表生成等业务的高频需求。相比于原生操作Office COM组件(兼容性差、依赖环境),Free Spire.Doc for .NET 是一款轻量、免费、无依赖的 Word 操作组件,完美兼容 C# 读取、解析 Word(.doc/.docx)格式的表格数据。

结合项目来看,下面会系统梳理如何用 C# 结合 Free Spire.Doc for .NET 库实现 Word 表格读取,包含完整代码、核心API解析等。

开发环境准备

1. 基础环境要求

  • Visual Studio 2019+
  • .NET框架:.NET Framework 4.0+ / .NET 6/8(本文示例基于 .NET 6)
  • 兼容 Word 格式:.doc / .docx

2. NuGet 安装组件(极简操作)

  • 右键项目 → 管理 NuGet 程序包;
  • 搜索 FreeSpire.Doc
  • 点击安装,自动引用程序集。

命令行安装:Install-Package FreeSpire.Doc

免费版限制:单文档最大500段落、25个表格,满足绝大多数个人/小型项目需求。

核心 API 知识点(必看)

从实现思路看,Free Spire.Doc 操作 Word 表格的核心对象,层级关系清晰:

类名作用
Document加载/操作整个 Word 文档
SectionWord 文档的节(容器)
TableWord 表格对象
TableRow表格的行
TableCell表格的单元格
Paragraph.Text拿到单元格内的纯文本

读取逻辑:加载文档 → 遍历文档节 → 遍历节内表格 → 遍历行 → 遍历单元格 → 提取文本。

C# 读取 Word 表格完整代码

理解这一步时,以下代码演示如何读取 Word 文档中所有表格的数据,同时输出到控制台。示例 Word 文档包含两个表格,如下所示图:

场景1:读取 Word 中所有表格数据

using Spire.Doc;
using System;
namespace ReadWordTable
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 初始化文档对象,加载Word文件
            Document doc = new Document();
            doc.LoadFromFile(@"E:表格.docx"); // 替换为你的Word路径
            // 2. 遍历Word文档中的所有节
            foreach (Section section in doc.Sections)
            {
                // 3. 遍历当前节中的所有表格
                foreach (Table table in section.Tables)
                {
                    Console.WriteLine("===================== 读取表格数据 =====================");
                    // 4. 遍历表格的每一行
                    foreach (TableRow row in table.Rows)
                    {
                        // 5. 遍历当前行的每一个单元格
                        foreach (TableCell cell in row.Cells)
                        {
                            // 6. 获取单元格文本(去除空字符)
                            string cellText = cell.Paragraphs[0].Text.Trim();
                            Console.Write(cellText + "t"); // 制表符分隔数据
                        }
                        Console.WriteLine(); // 换行
                    }
                }
            }
            // 释放资源
            doc.Close();
            Console.ReadLine();
        }
    }
}

运行代码后,控制台会按表格行列格式输出所有数据:

场景2:仅读取指定表格数据(精准读取)

也能够直接借助索引拿到指定表格,读取其中数据,效率更高:

// 获取【第一个表格】(索引从0开始)
Table targetTable = doc.Sections[0].Tables[0] as Table;

进阶:将 Word 表格数据写入 TXT / CSV 文件

结合项目来看,在真实项目中,读取 Word 表格后需将数据持久化保存,最常用的是导出为 TXT 纯文本CSV 文件

必备命名空间:操作文件需引入 System.IO,在代码顶部添加:

using System.IO;

示例 1:导出 Word 表格为纯 TXT 文本

特点:纯文本格式,用制表符分隔数据,可读性强,适合轻松存储。

using System;
using System.IO;
using Spire.Doc;

namespace ReadWordToTxt
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 加载Word文档
            Document doc = new Document();
            doc.LoadFromFile(@"E:表格.docx");

            // 2. 设置TXT保存路径
            string txtPath = @"Word表格数据.txt";

            // 3. 创建文件流,写入数据
            using (StreamWriter sw = new StreamWriter(txtPath, false, System.Text.Encoding.UTF8))
            {
                // 遍历所有节、表格、行、单元格
                foreach (Section section in doc.Sections)
                {
                    foreach (Table table in section.Tables)
                    {
                        sw.WriteLine("===================== 表格数据 =====================");
                        foreach (TableRow row in table.Rows)
                        {
                            string rowData = "";
                            foreach (TableCell cell in row.Cells)
                            {
                                // 拼接单元格文本,制表符分隔
                                rowData += cell.Paragraphs[0].Text.Trim() + "t";
                            }
                            // 写入一行数据
                            sw.WriteLine(rowData);
                        }
                    }
                }
            }

            // 4. 释放资源
            doc.Close();
            Console.WriteLine($"数据已成功写入:{txtPath}");
            Console.ReadLine();
        }
    }
}

生成的Word表格数据.txt文件:

示例 2:导出 Word 表格为 CSV 文件(建议)

亮点汇总:

  • 自动转义单元格逗号,避免格式错乱
  • UTF-8 编码,彻底解决 Excel 中文乱码
  • 直接双击可用 WPS/Excel 打开做数据分析
using System;
using System.IO;
using Spire.Doc;

namespace ReadWordToCsv
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 加载Word文档
            Document doc = new Document();
            doc.LoadFromFile(@"E:表格.docx");

            // 2. 设置CSV保存路径
            string csvPath = @"Word表格数据.csv";

            // 3. 写入CSV文件(UTF-8编码,解决中文乱码)
            using (StreamWriter sw = new StreamWriter(csvPath, false, System.Text.Encoding.UTF8))
            {
                foreach (Section section in doc.Sections)
                {
                    foreach (Table table in section.Tables)
                    {
                        foreach (TableRow row in table.Rows)
                        {
                            string rowData = "";
                            foreach (TableCell cell in row.Cells)
                            {
                                string cellText = cell.Paragraphs[0].Text.Trim();
                                // CSV格式优化:文本加双引号,避免单元格内逗号导致格式错乱
                                rowData += $""{cellText}",";
                            }
                            // 去除行尾多余逗号,写入文件
                            sw.WriteLine(rowData.TrimEnd(','));
                        }
                        // 表格之间空行分隔
                        sw.WriteLine();
                    }
                }
            }

            // 4. 释放资源
            doc.Close();
            Console.WriteLine($"数据已成功写入:{csvPath}");
            Console.ReadLine();
        }
    }
}

生成的Word表格数据.csv文件,用 Excel 打开可直接显示规整表格:

实际处理时,至此,我们完成了一套完整的 Word 表格数据读取方案。从文档加载、表格遍历到数据导出,整个过程同时不复杂,关键点包含:

  • 对象模型清晰DocumentSectionTableTableRowTableCell 层级分明,按序遍历即可拿到所需内容;
  • 代码简洁直接:无论是控制台输出还是导出 TXT / CSV 文件,核心代码都在 20 行以内,易于理解和维护;
  • 导出格式灵活:TXT 适合更快查看,CSV 则更适合数据交换与后续分析,两者都能满足日常开发需求。

结合项目来看,这种方式最大的优势在于轻量、无环境依赖,不需在服务器或客户端安装 Office 软件,也不涉及 COM 组件的繁琐设置,部署和维护都轻松很多。对于大多数需处理 Word 表格的业务场景——比如数据导入、报表自动化、内容提取等——这套方案足以覆盖常用需求。

从实现思路看,如果你在实际项目中遇到更复杂的表格结构(如嵌套表格、不规则合同时、单元格内混合内容等),能够在现有逻辑基础上进一步扩展。希望这篇文章能帮你更快上手,少走一些弯路。

到此这篇关于C#实现高效读取Word表格数据同时导出为CSV/TXT的文章就介绍到这了,更多相关C#读取Word表格数据内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多兼容脚本之家!

您可能感兴趣的文章:
  • C#采用Spire.Doc for .NET高效实现Word文档的文本、表格和图片数据提取
  • C#结合Spire.Doc实现自动化提取Word表格数据
  • 采用C#实现将Word 转文本存储到数据库并进行管理
  • C#实现读取多条数据记录并导出到Word
  • C#读取word中表格数据的方法实现
  • C# 采用Word模板导出数据的实现代码
  • C#实现将数据导出到word或者Excel中的方法

热门栏目