WpfDataGrid.Enhancements 0.9.3

WPF DataGrid 增强包（WpfDataGrid.Enhancements）

轻量级 WPF DataGrid 增强库：多列组合过滤、主题切换、数据导出（CSV / xlsx / PDF）与大数据虚拟化。 开源版 MIT 协议；Pro 版（xlsx / PDF 导出、正则过滤、大数据虚拟化）采用 RSA 签名授权。详见 docs/README.md 与设计文档 WPF_DataGrid_增强包_设计文档.md。

项目简介

本库以 Behavior + 附加属性 的方式增强原生 DataGrid，无需继承子类即可获得：

• 多列组合过滤：表头弹出过滤面板，支持文本包含 / 数值范围 / 日期区间 / 枚举多选，列间可配置 And / Or 组合；
• 主题切换：内置 Light / Dark 两套可替换主题资源，支持跟随系统；
• 一键导出：CSV（开源）、xlsx / PDF（Pro），xlsx 自带表头样式、自动列宽、单元格对齐与冻结表头；
• 大数据虚拟化：AsyncVirtualizingCollection<T> 按页异步加载，支撑十万级行数据流畅浏览。

功能特性（开源版 vs Pro 版）

界面预览

Demo 实测截图（浅色 / 深色，均来自真实渲染的 Demo 主窗口）：

浅色主题	深色主题

截图由 Demo 主窗口真实渲染生成，来源 demo/WpfDataGrid.Enhancements.Demo，可在本仓库 assets/screenshots/ 目录查看原图。

安装

NuGet 包发布后可通过以下命令安装（占位，发布前替换为实际包版本）：

# 开源版
dotnet add package WpfDataGrid.Enhancements

# Pro 版（需授权文件激活）
dotnet add package WpfDataGrid.Enhancements.Pro

目标框架：net8.0-windows + net462（双 TFM）。依赖（MIT 系）：Microsoft.Xaml.Behaviors.Wpf、Sylvan.Data.Excel（xlsx）、PdfSharp（PDF）。集成方式：Behavior 为主 + 附加属性为辅，不推荐子类。

快速开始

完整教程见 docs/guide/quick-start.md。

1. 挂载过滤（XAML 附加属性方式）

<Window x:Class="Demo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:enh="clr-namespace:WpfDataGrid.Enhancements;assembly=WpfDataGrid.Enhancements">
    <Grid>
        <DataGrid x:Name="Grid"
                  ItemsSource="{Binding Orders}"
                  enh:DataGridExtensions.EnableFiltering="True"
                  enh:DataGridExtensions.EnableExporting="True" />
    </Grid>
</Window>

2. CsvExportProvider 一行导出

using WpfDataGrid.Enhancements.Exporting;

var table = new TableData(
    new[] { "订单号", "客户", "金额" },
    new object?[][] { new object?[] { 1001, "张三", 199.5m } });

using var stream = File.Create("orders.csv");
new CsvExportProvider().Export(table, stream); // 一行导出

3. 主题切换

using WpfDataGrid.Enhancements.Theming;

DataGridThemeManager.ApplyTheme(ThemeMode.Dark);   // 深色
DataGridThemeManager.ApplyTheme(ThemeMode.Light);  // 浅色
DataGridThemeManager.ApplyTheme(ThemeMode.System); // 跟随系统

解决方案结构

WpfDataGrid.Enhancements.sln
├── src/
│   ├── WpfDataGrid.Enhancements/        开源核心库（过滤、主题、CSV 导出、集成基座）
│   ├── WpfDataGrid.Enhancements.Pro/    Pro 扩展库（xlsx/PDF 导出、正则过滤、大数据虚拟化、授权）
│   └── WpfDataGrid.Enhancements.LicenseTool/  授权签发工具（独立控制台）
├── demo/
│   └── WpfDataGrid.Enhancements.Demo/   Demo 示例（WPF 应用）
├── docs/                                项目文档（guide / api / licensing）
└── tests/
    └── WpfDataGrid.Enhancements.Tests/  xUnit 测试

关键 API

API 参考索引见 docs/api/README.md。

授权与激活

Pro 版（WpfDataGrid.Enhancements.Pro）采用 RSA-2048 / RSA-SHA256 签名授权：许可证为自包含 JSON 文件（扩展名 wpfdatagrid.enhancements.license），库内仅内嵌公钥验证签名，支持 Personal / Team / Enterprise 三种授权类型与功能掩码开关，未激活时自动进入试用模式（默认 30 天 / 5000 行）。

• 授权类型、激活步骤、试用限制、密钥管理、签发工具用法与 FAQ：见 docs/licensing/README.md
• 授权校验入口：LicenseManager.ValidateLicense() / LicenseManager.EnsureLicensed(ProFeature.XXX)
• 签发工具：WpfDataGrid.Enhancements.LicenseTool（独立控制台，不随 NuGet 分发）

路线图

参与贡献 / 反馈

• 欢迎提交 Issue 报告缺陷或建议新功能（占位，发布前替换为仓库地址）。
• 本仓库暂不接受未经讨论的外部 Pull Request，重大改动请先开 Issue 说明方案。
• 商业授权 / Pro 版咨询：见 docs/licensing/README.md。

构建

dotnet restore
dotnet build WpfDataGrid.Enhancements.sln   # 双 TFM 0 警告 0 错误
dotnet test tests/WpfDataGrid.Enhancements.Tests   # 全部测试通过