暂时更改一部分Skill
This commit is contained in:
1 parent
84b28f9672
commit
6d4629e4ac
53 files changed
+5293
-10
No files matched your search
@@ -0,0 +1,116 @@
|
||||
---
|
||||
name: reference-fast-wpf-grid
|
||||
description: >-
|
||||
MAX.FastWpfGrid 高性能表格完整使用指南(FastGridModelBase 模式、XAML 绑定、Excel 导出)。
|
||||
当用户处理百万行级别大数据表格、使用 MAX.FastWpfGrid、FastWpfGrid、FastGridControl、
|
||||
FastGridModelBase 或需要表格导出时自动加载。
|
||||
disable-model-invocation: false
|
||||
---
|
||||
|
||||
# MAX.FastWpfGrid 完整参考
|
||||
|
||||
## 概述
|
||||
|
||||
MAX.FastWpfGrid 是基于 **WriteableBitmap** 渲染的高性能 WPF 表格控件,不依赖 WPF 视觉树,所有内容绘制到位图上,实现百万行数据的流畅滚动。
|
||||
|
||||
- **NuGet 包**:`MAX.FastWpfGrid`(**禁止**旧包名 `FastWpfGrid`)
|
||||
- **命名空间 / 程序集**:`MAX.FastWpfGrid`(旧命名空间 `FastWpfGrid` 已废弃)
|
||||
- **本地源码**:`{LIBS_ROOT}MAX.FastWpfGrid\MAX.FastWpfGrid\`(路径变量见 `max-libraries-reference.md`)
|
||||
- **核心类型**:
|
||||
- `FastGridControl`:WPF 控件,通过 `Model` 属性绑定数据模型
|
||||
- `FastGridModelBase`:数据模型基类,继承后覆写 `GetRowHeaderText`、`GetColumnHeaderText`、`GetCellText` 方法提供数据
|
||||
- `FastGridCellImpl`:富文本单元格(图文混排、背景色),在 `GetCell()` 中使用
|
||||
- **建模模式**:通常封装一个 `TableModelBase` 抽象基类(继承 `FastGridModelBase`),统一处理行列头渲染和右键菜单分发
|
||||
|
||||
## 模型模式
|
||||
|
||||
继承 `FastGridModelBase`,覆写三个核心方法:
|
||||
|
||||
```csharp
|
||||
using MAX.FastWpfGrid;
|
||||
|
||||
public class XxxTableModel : FastGridModelBase
|
||||
{
|
||||
private readonly IReadOnlyList<XxxData> _data;
|
||||
|
||||
public XxxTableModel(IReadOnlyList<XxxData> data)
|
||||
: base(columnCount, data.Count)
|
||||
{
|
||||
_data = data;
|
||||
}
|
||||
|
||||
public override string GetRowHeaderText(int row)
|
||||
=> (row + 1).ToString();
|
||||
|
||||
public override string GetColumnHeaderText(int column)
|
||||
=> column switch
|
||||
{
|
||||
0 => "时间戳",
|
||||
1 => "通道A",
|
||||
2 => "通道B",
|
||||
_ => $"列{column}",
|
||||
};
|
||||
|
||||
public override string GetCellText(int row, int column)
|
||||
=> column switch
|
||||
{
|
||||
0 => _data[row].Timestamp.ToString(),
|
||||
1 => _data[row].ChannelA.ToString("0.####"),
|
||||
2 => _data[row].ChannelB.ToString("0.####"),
|
||||
_ => string.Empty,
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
需要颜色、图文混排的单元格,覆写 `GetCell()` 返回 `FastGridCellImpl` 实例。
|
||||
|
||||
## XAML 绑定
|
||||
|
||||
```xml
|
||||
xmlns:fwg="clr-namespace:MAX.FastWpfGrid;assembly=MAX.FastWpfGrid"
|
||||
|
||||
<fwg:FastGridControl
|
||||
Model="{Binding TableModel}"
|
||||
IsReadOnly="True"
|
||||
HeaderHeight="18"
|
||||
BackgroundColor="#fafafa"
|
||||
CellFontSize="12"/>
|
||||
```
|
||||
|
||||
## 导出 Excel(MiniExcel)
|
||||
|
||||
将 `FastGridModelBase` 子类包装为 `DbDataReader`,配合 **MiniExcel** 实现 XLSX 导出:
|
||||
|
||||
```csharp
|
||||
// 将 TableModel 适配为 DbDataReader 供 MiniExcel 流式写入
|
||||
private sealed class TableModelDataReader(TableModelBase model) : DbDataReader
|
||||
{
|
||||
private int _currentRow = -1;
|
||||
|
||||
public override int FieldCount => model.ColumnCount;
|
||||
public override bool HasRows => model.RowCount > 0;
|
||||
|
||||
public override bool Read()
|
||||
{
|
||||
_currentRow++;
|
||||
return _currentRow < model.RowCount;
|
||||
}
|
||||
|
||||
public override string GetName(int ordinal) => model.GetColumnHeaderText(ordinal) ?? string.Empty;
|
||||
public override object GetValue(int ordinal) => model.GetCellText(_currentRow, ordinal) ?? string.Empty;
|
||||
public override string GetString(int ordinal) => model.GetCellText(_currentRow, ordinal) ?? string.Empty;
|
||||
|
||||
// 其余 DbDataReader 抽象成员使用默认实现
|
||||
public override int RecordsAffected => -1;
|
||||
public override bool IsClosed => false;
|
||||
public override int Depth => 0;
|
||||
// ...
|
||||
}
|
||||
|
||||
// 导出 Excel
|
||||
using FileStream fileStream = new(filePath, FileMode.Create, FileAccess.Write, FileShare.None);
|
||||
using TableModelDataReader reader = new(tableModel);
|
||||
MiniExcel.SaveAs(fileStream, reader, excelType: ExcelType.XLSX);
|
||||
```
|
||||
|
||||
纯文本导出则直接循环调用 `GetCellText()` 写入 CSV/TSV 即可。
|
||||
Reference in new issue
Block a user