命令系统（ICommand）
- 1 RelayCommand实现
- 2 CanExecute控制按钮可用性
- 3 参数传递（CommandParameter）
- 3.1 静态参数绑定：
- 3.2 动态参数绑定：
- 3.3 复杂对象参数：
- 4 异步命令实现
- 5 常见问题排查
WPF的命令系统是MVVM模式中实现业务逻辑与UI交互的核心机制。本章将深入解析
ICommand接口的实现原理，并提供企业级应用中的最佳实践方案。
1 RelayCommand实现
通过自定义命令类解耦UI与业务逻辑：
基础实现模板：
public class RelayCommand : ICommand
{
private readonly Action _execute;
private readonly Func<bool> _canExecute;
public RelayCommand(Action execute, Func<bool> canExecute = null)
{
_execute = execute ?? throw new ArgumentNullException(nameof(execute));
_canExecute = canExecute;
}
public bool CanExecute(object parameter) => _canExecute?.Invoke() ?? true;
public void Execute(object parameter) => _execute();
public event EventHandler CanExecuteChanged
{
add => CommandManager.RequerySuggested += value;
remove => CommandManager.RequerySuggested -= value;
}
}
// 支持泛型参数的增强版
public class RelayCommand<T> : ICommand
{
private readonly Action<T> _execute;
private readonly Func<T, bool> _canExecute;
public RelayCommand(Action<T> execute, Func<T, bool> canExecute = null)
{
_execute = execute ?? throw new ArgumentNullException(nameof(execute));
_canExecute = canExecute;
}
public bool CanExecute(object parameter) =>
_canExecute?.Invoke((T)parameter) ?? true;
public void Execute(object parameter) => _execute((T)parameter);
public event EventHandler CanExecuteChanged
{
add => CommandManager.RequerySuggested += value;
remove => CommandManager.RequerySuggested -= value;
}
}
ViewModel中的使用示例：
public class MainViewModel
{
public RelayCommand SaveCommand { get; }
public RelayCommand<string> SearchCommand { get; }
public MainViewModel()
{
SaveCommand = new RelayCommand(ExecuteSave, CanSave);
SearchCommand = new RelayCommand<string>(ExecuteSearch);
}
private void ExecuteSave() => /* 保存逻辑 */;
private bool CanSave() => !string.IsNullOrEmpty(Content);
private void ExecuteSearch(string keyword) => /* 搜索逻辑 */;
}
2 CanExecute控制按钮可用性
命令的可用性状态与UI元素自动同步：
XAML绑定示例：
<Button Content="保存"
Command="{Binding SaveCommand}"
IsEnabled="{Binding SaveCommand.IsEnabled}"/>
动态更新策略：
- 自动更新（默认）：
// 通过CommandManager自动触发
CommandManager.InvalidateRequerySuggested();
- 手动通知：
// 在属性变更时触发
public string Content
{
set
{
_content = value;
OnPropertyChanged();
SaveCommand.RaiseCanExecuteChanged();
}
}
禁用状态样式优化：
<Style TargetType="Button">
<Style.Triggers>
<Trigger Property="IsEnabled" Value="False">
<Setter Property="Opacity" Value="0.5"/>
</Trigger>
</Style.Triggers>
</Style>
3 参数传递（CommandParameter）
支持多种参数传递方式：
3.1 静态参数绑定：
<Button Command="{Binding StatusCommand}"
CommandParameter="Approved"/>
3.2 动态参数绑定：
<ComboBox x:Name="statusList" SelectedValuePath="Tag"/>
<Button Command="{Binding UpdateCommand}"
CommandParameter="{Binding SelectedItem.Tag, ElementName=statusList}"/>
3.3 复杂对象参数：
// ViewModel
public RelayCommand<User> EditCommand { get; } =
new RelayCommand<User>(user => /* 编辑逻辑 */);
// XAML
<ListBox x:Name="userList">
<ListBox.ItemTemplate>
<DataTemplate>
<Button Content="编辑"
Command="{Binding DataContext.EditCommand,
RelativeSource={RelativeSource AncestorType=ListBox}}"
CommandParameter="{Binding}"/>
</DataTemplate>
</ListBox.ItemTemplate>
</ListBox>
4 异步命令实现
处理长时间运行任务的最佳实践：
异步命令模板：
public class AsyncCommand : ICommand
{
private readonly Func<Task> _execute;
private readonly Func<bool> _canExecute;
private bool _isExecuting;
public AsyncCommand(Func<Task> execute, Func<bool> canExecute = null)
{
_execute = execute;
_canExecute = canExecute;
}
public bool CanExecute(object parameter) =>
!_isExecuting && (_canExecute?.Invoke() ?? true);
public async void Execute(object parameter)
{
if (CanExecute(parameter))
{
try
{
_isExecuting = true;
RaiseCanExecuteChanged();
await _execute();
}
finally
{
_isExecuting = false;
RaiseCanExecuteChanged();
}
}
}
public void RaiseCanExecuteChanged() =>
CommandManager.InvalidateRequerySuggested();
public event EventHandler CanExecuteChanged
{
add => CommandManager.RequerySuggested += value;
remove => CommandManager.RequerySuggested -= value;
}
}
使用示例：
public AsyncCommand LoadDataCommand { get; }
public MainViewModel()
{
LoadDataCommand = new AsyncCommand(LoadDataAsync, () => !IsLoading);
}
private async Task LoadDataAsync()
{
IsLoading = true;
try
{
await DataService.FetchData();
}
finally
{
IsLoading = false;
}
}
5 常见问题排查
问题1：命令不触发
- 检查
CanExecute返回值是否为true - 确认
DataContext是否正确继承 - 验证参数类型匹配（使用
RelayCommand<T>时）
问题2：CanExecute不自动更新
- 确保调用
CommandManager.InvalidateRequerySuggested() - 检查是否在属性变更时触发通知
- 对于非UI线程更新，使用
Dispatcher调用：
Application.Current.Dispatcher.Invoke(CommandManager.InvalidateRequerySuggested);
问题3：参数绑定失败
- 使用调试转换器检查参数值：
<Button CommandParameter="{Binding SelectedItem, Converter={local:DebugConverter}}"/>
- 确认参数类型与命令泛型类型匹配
问题4：内存泄漏
- 及时取消命令订阅：
public void Dispose()
{
SaveCommand.CanExecuteChanged -= OnSaveCommandChanged;
}
本章小结
通过本章学习，开发者应掌握：
- 实现符合生产标准的
RelayCommand - 通过
CanExecute控制UI状态 - 多种参数传递模式的应用
- 异步命令的安全实现
- 常见命令问题的诊断方法
建议实践以下场景：
- 开发带撤销/重做功能的编辑器
- 实现分页数据加载命令
- 创建支持多选操作的批量处理命令
下一章将深入讲解MVVM模式的核心架构与实现细节。
