讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

C#怎么读取Excel合并单元格中的内容?

千静吖_7408

千静吖_7408

发布时间:2026-11-21 08:40:22

|

364人浏览过

|

来源于php中文网

原创

使用npoi库读取excel合并单元格内容时,核心做法是调用 isheet.getmergedregioncount() 获取合并区域总数,并通过 isheet.getmergedregion(i) 遍历每个区域。对于合并区域内的所有单元格,其实际数据仅存在于该区域的左上角单元格中,因此只需判断当前单元格的行号和列号是否等于某个合并区域的起始坐标,若是则直接读取该位置的值,否则跳过或复用已读数据。

C#怎么读取Excel合并单元格中的内容?

如何识别单个合并区域的边界范围

要确定一个合并单元格的范围,需要解析 MergedCell 对象中的 FirstRow、LastRow、FirstCol 和 LastCol 属性。这些属性定义了该区域在网格中的绝对坐标。例如,若某区域从第0行第0列开始,到第2行第1列结束,则该区域覆盖了6个物理单元格,但逻辑上它们属于同一个值。

C#怎么读取Excel合并单元格中的内容?

Excel公式工具(专业版)
Excel公式工具(专业版)

从自然语言描述生成Excel公式,诊断表格错误,支持VLOOKUP、条件求和等常用函数。

下载
using NPOI.HSSF.UserModel;
using NPOI.SS.UserModel;
using System;

class Program {
    static void Main() {
        // 假设文件存在且包含合并单元格
        using var fs = new FileStream("data.xlsx", FileMode.Open, FileAccess.Read);
        var wb = new XSSFWorkbook(fs);
        var sheet = wb.GetSheetAt(0);

        int count = sheet.NumMergedRegions;
        for (int i = 0; i < count; i++) {
            var region = sheet.GetMergedRegion(i);
            Console.WriteLine($"Region {i}: Rows [{region.FirstRow}, {region.LastRow}], Cols [{region.FirstCol}, {region.LastCol}]");
        }
    }
}

如何在遍历时避免重复读取同一值

在逐行逐列遍历单元格时,必须维护一个状态来标记哪些单元格已经被作为“主单元格”处理过。通常的做法是在遍历到某个单元格时,检查它是否是所在合并区域的左上角(即 row == region.FirstRow && col == region.FirstCol)。如果是,则读取并存储该值;如果不是,则忽略该单元格,因为它的值与左上角单元格相同。

C#怎么读取Excel合并单元格中的内容?

using NPOI.HSSF.UserModel;
using NPOI.SS.UserModel;
using System;
using System.Collections.Generic;

class Program {
    static void Main() {
        using var fs = new FileStream("data.xlsx", FileMode.Open, FileAccess.Read);
        var wb = new XSSFWorkbook(fs);
        var sheet = wb.GetSheetAt(0);

        var mergedRegions = new List<ICellRange>();
        for (int i = 0; i < sheet.NumMergedRegions; i++) {
            var region = sheet.GetMergedRegion(i);
            mergedRegions.Add(new CellRange(region.FirstRow, region.LastRow, region.FirstCol, region.LastCol));
        }

        int lastRow = sheet.LastRowNum;
        for (int r = 0; r <= lastRow; r++) {
            var row = sheet.GetRow(r);
            if (row == null) continue;
            int lastCol = row.LastCellNum;
            for (int c = 0; c < lastCol; c++) {
                var cell = row.GetCell(c);
                if (cell == null) continue;

                bool isMainCell = false;
                foreach (var region in mergedRegions) {
                    if (r >= region.StartRow && r <= region.EndRow &&
                        c >= region.StartCol && c <= region.EndCol) {
                        if (r == region.StartRow && c == region.StartCol) {
                            isMainCell = true;
                        } else {
                            // 非主单元格,跳过
                            goto NextCell;
                        }
                    }
                }

                if (isMainCell) {
                    Console.WriteLine($"Value at ({r},{c}): {cell.StringCellValue}");
                }

                NextCell: ;
            }
        }
    }
}
struct CellRange {
    public int StartRow, EndRow, StartCol, EndCol;
    public CellRange(int sR, int eR, int sC, int eC) {
        StartRow = sR; EndRow = eR; StartCol = sC; EndCol = eC;
    }
}

当合并单元格跨越空行时如何处理索引偏移

如果Excel文件中存在完全空的行,XSSFSheet 的 GetRow() 可能会返回 null,这会导致基于物理行号的逻辑判断出现偏差。此时应依赖 MergedRegion 提供的绝对坐标进行判断,而不是依赖当前遍历到的行对象是否存在。只要 MergedRegion 中记录的 FirstRow 等属性是准确的,即使中间有空行,左上角单元格的定位依然准确。建议在读取前先将所有合并区域加载到内存列表中,并在遍历时优先匹配列表而非依赖行的连续性。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

1232

2023.08.08

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

3671

2023.08.31

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

985

2024.03.13

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2695

2024.03.14

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

372

2026.02.03

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

449

2026.02.06

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

631

2026.03.11

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

349

2026.04.13

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 46万人学习

成为PHP架构师-自制PHP框架
成为PHP架构师-自制PHP框架

共28课时 | 3.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn