在 Avalonia 中,用 ViewModel 执行异步命令最推荐的方式是结合 ReactiveUI 与 ReactiveUI.SourceGenerators,通过
[ReactiveCommand]特性自动生成线程安全、可取消、支持状态绑定的异步命令。它天然适配 Avalonia 的数据绑定机制,无需手动处理调度或 UI 线程切换。
使用 ReactiveCommand 定义异步操作
只需在 ViewModel 中标记一个
async void或
async Task方法,并加上
[ReactiveCommand]特性,Source Generators 就会自动为你生成命令对象、
CanExecute观察流、执行状态属性(如
IsExecuting)等: 方法签名必须是
async void或
async Task,参数可带
CancellationToken支持自动注入取消令牌,能响应 UI 层的 Cancel 操作 内部自动调用
Dispatcher.UIThread.InvokeAsync更新绑定属性,无需手动调度 生成的命令自带
IsExecuting、
ExecutionTask等可观测属性,方便绑定按钮禁用/进度条
绑定到 View 并控制 UI 状态
在 AXAML 中直接绑定命令和状态属性即可实现响应式交互:
Command="{Binding ExecuteAsync}" 绑定触发逻辑
IsEnabled="{Binding IsNotExecuting}" 或 IsEnabled="{Binding !IsExecuting}" 控制按钮是否可点
Content="{Binding Status}" 实时显示“执行中…10%”“已完成”等提示
若需取消按钮,再定义一个 [ReactiveCommand(CanExecute = nameof(IsExecuting))]的
CancelExecution方法
注意取消与资源清理细节
异步命令常涉及长时间运行任务,必须正确处理取消和释放:
在方法体内用CancellationToken.ThrowIfCancellationRequested()主动检查中断 避免直接 new CancellationTokenSource();建议用
CancellationTokenSource.CreateLinkedTokenSource(cancellationToken)合并传入的命令级 token 和自定义逻辑 在
finally块中调用
_cancellationTokenSource?.Dispose(),防止内存泄漏 不要在异步方法里直接修改 UI 控件属性(如
myTextBlock.Text = "xxx"),始终走 Reactive 属性绑定
替代方案:手写 ICommand + async/await(不推荐)
虽然可以手动实现
ICommand并在
Execute中启动
Task.Run(async () => {...}),但这种方式容易出错:
无法自动同步 UI 线程,更新属性可能抛出跨线程异常
缺少内置的 IsExecuting、
CanExecute变化通知机制 取消逻辑需自行管理,难以与按钮的
CommandParameter或外部信号联动 违背 ReactiveUI 的响应式设计初衷,增加维护成本
不复杂但容易忽略:关键不是“能不能跑异步”,而是“状态是否可观察、取消是否可传播、UI 是否安全更新”。用好
[ReactiveCommand]就覆盖了这三点。
