C#使用NPOI进行Excel和Word文件处理

 更新时间:2024年03月19日 09:33:25   作者:承蒙_关照  
NPOI是一个基于.NET的API,用于读写微软的OLE 2 Compound Document formats,如Microsoft Office Excel和Word,下面就跟随小编一起来看看它的具体操作吧

脚本之家 / 编程助手:解决程序员“几乎”所有问题!
脚本之家官方知识库 → 点击立即使用

一、引言

在.NET开发中,操作Office文档(特别是Excel和Word)是一项常见的需求。然而,在服务器端或无Microsoft Office环境的场景下,直接使用Office Interop可能会面临挑战。为了解决这个问题,开源库NPOI应运而生,它提供了无需安装Office即可创建、读取和修改Excel (.xls, .xlsx) 和 Word (.doc) 文件的能力。

二、NPOI简介

NPOI是一个基于.NET的API,用于读写微软的OLE 2 Compound Document formats,如Microsoft Office Excel和Word。它是Apache POI项目的.NET移植版本,允许开发者在没有安装Office的情况下处理这些格式的文件。

三、主要组件与方法

1. 安装与引用

Install-Package NPOI

或者在Visual Studio中右键项目 -> 管理NuGet程序包 -> 搜索并安装NPOI。

2. 引用命名空间

1
2
3
4
using NPOI.SS.UserModel; // Excel相关的接口和类
using NPOI.XSSF.UserModel; // 处理.xlsx文件
using NPOI.HSSF.UserModel; // 处理.xls文件
using System.IO; // 文件操作

3. 创建/打开工作簿

创建一个新的Excel工作簿(.xlsx):

var workbook = new XSSFWorkbook();

打开一个现有的Excel文件(.xlsx或.xls):

1
2
3
FileStream file = new FileStream("path_to_your_file.xlsx", FileMode.Open, FileAccess.Read);
var workbook = new XSSFWorkbook(file); // .xlsx格式
var workbook = new HSSFWorkbook(file); // .xls格式

4. 创建/获取工作表

创建新的工作表:

ISheet sheet = workbook.CreateSheet("Sheet1");

获取已存在的工作表:

ISheet sheet = workbook.GetSheetAt(0); // 获取索引为0的工作表

5. 写入单元格数据

创建行与单元格:

1
2
IRow row = sheet.CreateRow(rowIndex);
ICell cell = row.CreateCell(columnIndex);

设置单元格值:

1
2
cell.SetCellValue("文本内容"); // 文本
cell.SetCellValue(12345); // 数字

6. 合并单元格

1
2
var region = new CellRangeAddress(startRow, endRow, startColumn, endColumn);
sheet.AddMergedRegion(region);

7. 设置单元格样式

创建样式对象:

var style = workbook.CreateCellStyle();

设置样式属性(如字体、颜色、对齐方式等):

1
2
3
4
style.Alignment = HorizontalAlignment.Center;
IFont font = workbook.CreateFont();
font.Boldweight = (short)FontBoldWeight.Bold;
style.SetFont(font);

应用到单元格:

cell.CellStyle = style;8. 保存文件

1
2
3
FileStream outputStream = new FileStream("output.xlsx", FileMode.Create);
workbook.Write(outputStream);
outputStream.Close();

9. 关闭资源

确保关闭Workbook以及相关的文件流以释放资源:

1
2
workbook.Close();
file.Close();

四、高级功能

  • 读取现有文件:通过FileStream打开并读取Excel文件内容。
  • 读取公式结果:通过ICell.CachedFormulaResultType或ICell.CellFormula属性获取公式计算结果。
  • 操作图表和图片:NPOI支持插入、更新和删除Excel中的图表和图片。
  • 处理Word文档:通过XWPFDocument类来创建、读取和修改Word(.doc)文件。

五、总结

NPOI库凭借其强大的功能和轻量级设计,已成为.NET环境下处理Office文档的标准工具之一。无论是在Web应用程序后台处理用户上传的Excel文件,还是在批处理任务中生成报表,NPOI都能提供高效且易于使用的解决方案。通过深入理解和熟练运用NPOI的各种方法,开发者可以轻松应对各种复杂的文档处理任务。

六、完整的读取数据例子

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
using NPOI.HSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
  public void ReadExcelFile(string filePath)
    {
        // 创建一个FileStream对象来打开Excel文件
        using (FileStream file = new FileStream(filePath, FileMode.Open, FileAccess.Read))
        {
            // 根据文件扩展名选择合适的Workbook实现
            IWorkbook workbook;
            if (Path.GetExtension(filePath).ToLower() == ".xlsx")
            {
                workbook = new XSSFWorkbook(file);
            }
            else
            {
                workbook = new HSSFWorkbook(file); // 适用于.xls文件
            }
  
            // 获取第一个工作表(索引从0开始)
            ISheet sheet = workbook.GetSheetAt(0);
  
            // 遍历所有行
            for (int rowIndex = 0; rowIndex <= sheet.LastRowNum; rowIndex++)
            {
                IRow row = sheet.GetRow(rowIndex);
  
                // 如果当前行不为空,则遍历所有单元格
                if (row != null)
                {
                    for (int cellIndex = 0; cellIndex < row.LastCellNum; cellIndex++)
                    {
                        ICell cell = row.GetCell(cellIndex);
  
                        // 检查单元格是否存在并获取其数据类型和值
                        if (cell != null)
                        {
                            switch (cell.CellType)
                            {
                                case CellType.Numeric:
                                    double numericValue = cell.NumericCellValue;
                                    Console.WriteLine($"第{rowIndex + 1}行,第{cellIndex + 1}列:{numericValue}");
                                    break;
                                case CellType.String:
                                    string stringValue = cell.StringCellValue;
                                    Console.WriteLine($"第{rowIndex + 1}行,第{cellIndex + 1}列:{stringValue}");
                                    break;
                                case CellType.Formula:
                                    // 如果需要显示公式计算结果,使用CachedFormulaResultType
                                    if (cell.CachedFormulaResultType == CellType.Numeric)
                                    {
                                        double formulaValue = cell.NumericCellValue;
                                        Console.WriteLine($"第{rowIndex + 1}行,第{cellIndex + 1}列(公式结果):{formulaValue}");
                                    }
                                    else if (cell.CachedFormulaResultType == CellType.String)
                                    {
                                        string formulaValue = cell.StringCellValue;
                                        Console.WriteLine($"第{rowIndex + 1}行,第{cellIndex + 1}列(公式结果):{formulaValue}");
                                    }
                                    // 其他类型的公式处理...
                                    break;
                                default:
                                    // 对于日期、布尔值等其他类型,做相应处理
                                    break;
                            }
                        }
                        else
                        {
                            Console.WriteLine($"第{rowIndex + 1}行,第{cellIndex + 1}列:空单元格");
                        }
                    }
                }
            }
  
            // 关闭workbook以释放资源
            workbook.Close();
        }
    }

在这个例子中,我们首先打开了指定路径下的Excel文件,并根据文件类型创建了相应的HSSFWorkbook或XSSFWorkbook对象。然后,我们循环遍历每一行和每一列,获取每个单元格的内容,并根据单元格类型输出对应的值。

请确保已安装NPOI NuGet包并在项目中引用了必要的命名空间。

七、保存数据例子

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
using NPOI.HSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;
 public void SaveDataToExcel(string filePath)
    {
        // 创建一个新的HSSFWorkbook(适用于.xls格式)或XSSFWorkbook(适用于.xlsx格式)
        IWorkbook workbook = new XSSFWorkbook(); // 使用.xlsx格式
  
        // 创建新的工作表并设置名称
        ISheet sheet = workbook.CreateSheet("Sheet1");
  
        // 创建第一行数据
        IRow headerRow = sheet.CreateRow(0);
        headerRow.CreateCell(0).SetCellValue("Name");
        headerRow.CreateCell(1).SetCellValue("Age");
        headerRow.CreateCell(2).SetCellValue("City");
  
        // 添加三行数据
        for (int i = 1; i <= 3; i++)
        {
            IRow dataRow = sheet.CreateRow(i);
  
            dataRow.CreateCell(0).SetCellValue($"Person {i}");
            dataRow.CreateCell(1).SetCellValue(i * 10); // 年龄假设为i*10
            dataRow.CreateCell(2).SetCellValue($"City{i}");
  
            // 设置单元格样式(可选,例如设置字体加粗和居中)
            ICellStyle style = workbook.CreateCellStyle();
            style.Alignment = HorizontalAlignment.Center;
            IFont font = workbook.CreateFont();
            font.Boldweight = (short)FontBoldWeight.Bold;
            style.SetFont(font);
            dataRow.Cells[0].CellStyle = style;
        }
  
        // 保存到文件
        using (FileStream fileStream = new FileStream(filePath, FileMode.Create, FileAccess.Write))
        {
            workbook.Write(fileStream);
        }
  
        // 关闭workbook以释放资源
        workbook.Close();
    }

在这个例子中,我们首先创建了一个新的XSSFWorkbook对象,并在其中创建了一个名为"Sheet1"的工作表。接着,我们在表头添加了列名,并插入了三行示例数据。为了演示单元格样式的设置,我们将第一列的数据设置为了加粗和居中的样式。最后,将整个工作簿内容写入指定路径的Excel文件。

请注意,根据实际需求选择创建HSSFWorkbook或XSSFWorkbook,以及调整保存的数据和样式。确保已安装NPOI NuGet包并在项目中引用了必要的命名空间。

到此这篇关于C#使用NPOI进行Excel和Word文件处理的文章就介绍到这了,更多相关C# NPOI处理文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

蓄力AI

微信公众号搜索 “ 脚本之家 ” ,选择关注

程序猿的那些事、送书等活动等着你

原文链接:https://www.cnblogs.com/Z1000W/p/18080019

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若内容造成侵权/违法违规/事实不符,请将相关资料发送至 reterry123@163.com 进行投诉反馈,一经查实,立即处理!

相关文章

  • C#实现网页截图功能

    C#实现网页截图功能

    这篇文章主要介绍了C#实现网页截图功能,是非常实用的一个功能,需要的朋友可以参考下
    2014-08-08
  • C#中查找Dictionary中的重复值的方法

    C#中查找Dictionary中的重复值的方法

    这篇文章主要介绍了C#中查找Dictionary中的重复值的方法,需要的朋友可以参考下
    2015-09-09
  • .NET操作NPOI实现Excel的导入导出

    .NET操作NPOI实现Excel的导入导出

    NPOI是指构建在POI 3.x版本之上的一个程序,NPOI可以在没有安装Office的情况下对Word或Excel文档进行读写操作,下面小编为大家介绍了如何操作NPOI实现Excel的导入导出,需要的可以参考一下
    2023-09-09
  • C#数据类型实现背包、队列和栈

    C#数据类型实现背包、队列和栈

    本文详细讲解了C#数据结构类型,并实现背包、队列和栈的方法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-04-04
  • C#中的并发编程与.NET任务并行库的使用示例和常见问题

    C#中的并发编程与.NET任务并行库的使用示例和常见问题

    在现代软件开发中,.NET Framework通过引入任务并行库(TPL)和并发集合类型,简化了并发复杂性,提高程序的性能、可维护性和可扩展性,并发集合设计上允许多线程安全访问,此外,TPL通过Task类简化异步操作,正确使用这些工具可避免死锁和竞争条件等常见问题
    2024-09-09
  • 如何使用VS中的快捷键快速格式化代码使好看,整齐

    如何使用VS中的快捷键快速格式化代码使好看,整齐

    这篇文章主要介绍了如何使用VS中的快捷键快速格式化代码使好看,整齐,非常不错具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-04-04
  • C#安装OpenCvSharp4的实现步骤

    C#安装OpenCvSharp4的实现步骤

    OpenCv是一款开源的图像处理库,本文就介绍了C#安装OpenCvSharp4的实现步骤,具有一定的参考价值,感兴趣的可以了解一下
    2022-05-05
  • C# 给PPT中的图表添加趋势线的方法

    C# 给PPT中的图表添加趋势线的方法

    本文内容分享通过C#程序代码给PPT文档中的图表添加数据趋势线的方法,需要的朋友可以参考下面文章的具体内容
    2021-09-09
  • 创建execl导入工具类的步骤

    创建execl导入工具类的步骤

    这篇文章主要介绍了创建execl导入工具类的步骤,需要的朋友可以参考下
    2014-04-04
  • C#正则表达式(Regex类)用法实例总结

    C#正则表达式(Regex类)用法实例总结

    正则表达式的主要作用是验证字符串的值是否满足一定的规则,在页面输入数据验证方面的应用比较多,下面这篇文章主要给大家介绍了关于C#正则表达式(Regex类)用法的相关资料,需要的朋友可以参考下
    2022-08-08

最新评论