Avalonia DataGrid 多选需设 SelectionMode="Extended" 并用 Behavior 绑定 SelectedItems;SelectedItem 仅表焦点行,SelectedItems 才存全部选中项;注意 NuGet 包、主题、集合类型及通知机制。

Avalonia DataGrid 默认不支持直接绑定多选集合,SelectionMode 仅控制选择行为模式(如单选、扩展多选),但不会自动同步选中项到 ViewModel。要实现真正可用的多选功能,需配合行为(Behavior)或手动监听事件完成双向同步。
设置 SelectionMode 为 Extended 或 Multiple
这是启用多选操作的前提。Extended 允许按 Ctrl/Shift 多选,Multiple 在 Avalonia 当前版本中效果等同于 Extended(官方文档与实际行为一致):
- 在 XAML 中设置:
SelectionMode="Extended" - 确保
CanUserSelectRows="True"(默认为 true,但显式声明更稳妥) - 禁用
SelectionMode="Single"或未设置时,将无法进行多选操作
用 Behavior 绑定 SelectedItems
官方 DataGrid 不提供 SelectedItems 的依赖属性绑定,需借助自定义 Behavior 实现 MVVM 同步:
- 创建
DataGridSelectedItemsBehavior类,监听SelectionChanged事件 - 在后台代码中暴露
IList SelectedItems { get; set; }属性(推荐用ObservableCollection或INotifyCollectionChanged实现) - XAML 中通过
引入并绑定:
注意 SelectedItem 和 SelectedItems 的区别
SelectedItem 是单值绑定,仅反映当前“焦点行”;SelectedItems 才是真正被勾选的全部项集合(类型为 IList):
- 不要仅靠
SelectedItem判断多选结果 - 获取选中数据时,应转换为具体类型:
var selected = SelectedItems.Cast().ToList(); - 若绑定源是
ObservableCollection,建议在 ViewModel 中维护一个独立的ObservableCollection用于存储选中项,避免直接操作SelectedItems引发类型不匹配
避免常见陷阱
多选功能容易因配置疏漏失效:
- 忘记安装
Avalonia.Xaml.BehaviorsNuGet 包 → Behavior 无法解析 - 未在
App.axaml中引入Fluent.xaml或 DataGrid 主题 → 控件样式异常,部分交互不可见 - 绑定的
ItemsSource使用普通List而非ObservableCollection→ 数据更新后 UI 不响应,影响选择状态渲染 - ViewModel 属性未标记
[Reactive](若使用 ReactiveUI)或未实现INotifyPropertyChanged→SelectedItems变化无法通知 UI










