ClosedXML 数据排序功能详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00137/article/details/148507493

ClosedXML 数据排序功能详解

ClosedXML ClosedXML is a .NET library for reading, manipulating and writing Excel 2007+ (.xlsx, .xlsm) files. It aims to provide an intuitive and user-friendly interface to dealing with the underlying OpenXML API. 项目地址: https://gitcode.com/gh_mirrors/cl/ClosedXML

概述

ClosedXML 是一个强大的 .NET 库，用于操作 Excel 文件。其中数据排序功能是处理 Excel 表格数据时最常用的功能之一。本文将深入讲解 ClosedXML 中的数据排序功能，包括排序算法原理、使用方法以及实际应用示例。

排序算法原理

ClosedXML 的排序算法与 Excel 保持一致，按照数据类型和值进行排序：

逻辑值：false 小于 true
数字：按数值大小排序
文本：按当前区域设置排序（空字符串通常是最小的文本值）
错误值：排序时保持相对顺序不变
空白单元格：
- 升序时排在最后：数字 → 文本 → 逻辑值 → 错误值 → 空白
- 降序时排在最后：错误值 → 逻辑值 → 文本 → 数字 → 空白

重要特性：

排序是稳定的（相同值保持原有相对顺序）
只能基于单元格值排序，不支持按单元格或字体颜色排序

排序控制参数

1. 大小写敏感标志 (matchCase)

控制文本排序时是否区分大小写：

false（默认）：不区分大小写，"Hello" 和 "hello" 视为相同
true：区分大小写，排序顺序取决于当前区域设置

2. 忽略空白标志 (ignoreBlanks)

控制空白单元格的处理方式：

true（默认）：空白单元格始终排在最后
false：空白单元格视为空字符串，与文本值一起排序

技术提示：在 Excel 中输入单引号(')并按回车可创建空字符串单元格，TYPE 函数会返回 2（文本类型）。要去除显示的单引号，可将单元格值复制到其他单元格。

行排序方法

行排序是 ClosedXML 中最常用的排序方式，主要通过 IXLRange.Sort() 方法实现：

// 基本排序方法
IXLRange.Sort(string columnsToSortBy, XLSortOrder sortOrder, 
              bool matchCase = false, bool ignoreBlanks = true)

// 简化版本
IXLRange.Sort(int columnToSortBy, XLSortOrder sortOrder, 
              bool matchCase = false, bool ignoreBlanks = true)

// 使用 SortColumns 属性配置排序
IXLRange.Sort()

排序列参数说明

columnsToSortBy 参数格式：

多列用逗号分隔（如 "2 ASC, 3 DESC"）
列可以用数字（如 5）或字母（如 E）表示，相对于当前范围
排序方向可选 ASC（升序）、DESC（降序）或省略（使用 sortOrder 参数）

行排序示例

using var wb = new XLWorkbook();
var ws = wb.AddWorksheet();
ws.Column("D").Style.NumberFormat.SetNumberFormatId((int)XLPredefinedFormat.Number.PercentInteger);
var range = ws.Cell("B3").InsertData(new[]
{
    new object[]{ "Pastry",    "Sold", "Margin" },
    new object[]{ "Cake",      14,     0.25 },
    new object[]{ "Croissant", 15,     0.60 },
    new object[]{ "Fig Roll",  56,     0.50 },
    new object[]{ "Waffle",    74,     0.60 },
});
range.CopyTo(ws.Cell("F3"));
var dataRangeOfCopy = ws.Range("F4:H7");

// 按第3列降序，然后按第2列降序排序
dataRangeOfCopy.Sort("3 DESC, 2 DESC");
wb.SaveAs("sort-rows-example.xlsx");

执行结果将先按利润率（Margin）降序，利润率相同的再按销量（Sold）降序排列。

列排序方法

当数据按列排列时，可以使用 IXLRange.SortLeftToRight() 方法。这种方法比行排序功能有限，不能指定排序列的顺序，而是按第一行、第二行等顺序依次排序。

列排序示例

using var wb = new XLWorkbook();
var ws = wb.AddWorksheet();
ws.Row(5).Style.NumberFormat.SetNumberFormatId((int)XLPredefinedFormat.Number.PercentInteger);
var range = ws.Cell("B3").InsertData(new[]
{
    new object[]{ "Pastry", "Waffle", "Fig Roll", "Cake", "Croissant", },
    new object[]{ "Sold",         74,         56,     14,          15, },
    new object[]{ "Margin",     0.60,       0.50,   0.25,        0.60, },
});
range.CopyTo(ws.Cell("H3"));
var dataRangeOfCopy = ws.Range("I3:L5");

// 配置排序规则：先按第3行降序，再按第2行降序
dataRangeOfCopy.SortRows.Add(3, XLSortOrder.Descending);
dataRangeOfCopy.SortRows.Add(2, XLSortOrder.Descending);
dataRangeOfCopy.SortLeftToRight();
wb.SaveAs("sort-cols-example.xlsx");

此示例将先按利润率（Margin）降序，利润率相同的再按销量（Sold）降序排列各列。