Avalonia如何将DataGrid数据导出到Excel Avalonia数据导出

来源：这里教程网时间：2026-02-21 17:36:59 作者：

Avalonia 本身不内置 Excel 导出功能，需借助第三方库（如 EPPlus 或 NPOI）将

DataGrid

绑定的数据源导出为 .xlsx 文件。关键在于：获取数据源（通常是

IEnumerable<t></t>

）、映射字段、写入工作表，最后保存文件。

获取 DataGrid 的原始数据源

DataGrid

的数据通常来自

ItemsSource

，它可能是

ObservableCollection<t></t>

、

List<t></t>

或其他可枚举集合。避免直接操作 UI 行（如

DataGrid.Items

），而应从 ViewModel 或绑定源中提取干净数据：

确保 ViewModel 中暴露了可导出的数据集合（例如
public ObservableCollection<Person> People { get; } = new();</li> <li>若使用 <code>DataGrid.ItemsSource
绑定到表达式（如
{Binding FilteredItems}
），导出时也应调用同一属性获取最新数据注意处理筛选/排序后的视图——如果需要导出当前显示内容，且使用了
ICollectionView
（如
CollectionViewSource
），应遍历其
Cast<t>()</t>
结果而非原始源

使用 EPPlus 写入 Excel（推荐 .NET 6+）

注意：EPPlus 6+ 需要商业许可用于企业用途；个人/开源项目可免费使用。也可选用 MIT 协议的 NPOI（更轻量但 API 略冗长）。

安装 NuGet 包：

Install-Package EPPlus

示例代码（导出到本地文件）：

创建
ExcelPackage
实例添加工作表，设置标题行（取自 T 的
PropertyInfo.Name
或自定义特性） 逐行写入数据（支持值类型、字符串、日期等；跳过复杂对象或委托） 调用
SaveAsAsync(fileStream)
保存，配合 Avalonia 的
OpenFileDialog
获取保存路径

处理常见问题

导出过程容易忽略的细节：

中文乱码：EPPlus 默认 UTF-8，无需额外设置；确保 Excel 应用以 UTF-8 打开（现代 Excel 通常自动识别） 日期格式错乱：写入
DateTime
后，显式设置单元格样式：
worksheet.Cells[row, col].Style.Numberformat.Format = "yyyy-mm-dd hh:mm:ss";
空值/Null 异常：写入前判空，例如
cell.Value = item.Property?.ToString() ?? "";
性能优化：大数据量（>1w 行）建议关闭自动计算、禁用公式重算：
package.Workbook.CalculateMode = OfficeOpenXml.ExcelCalculationMode.Manual;

封装成可复用的导出方法

建议在 ViewModel 或工具类中封装通用导出逻辑，例如：

接收
IEnumerable<t></t>
和列名映射（支持
[Display(Name = "...")]
特性）支持异步导出 + 进度通知（通过
IProgress<int></int>
）返回
Task<bool></bool>
表示是否成功，并在 UI 层弹出提示（如
DialogHost.Show(...)
）与 Avalonia 的
StorageProvider
集成，调用系统保存对话框