WPF的交互核心：命令系统（ICommand）

命令系统（ICommand）

- [1 RelayCommand实现](#1 RelayCommand实现)
- [2 CanExecute控制按钮可用性](#2 CanExecute控制按钮可用性)
- [3 参数传递（CommandParameter）](#3 参数传递（CommandParameter）)
- - [3.1 静态参数绑定：](#3.1 静态参数绑定：)
  - [3.2 动态参数绑定：](#3.2 动态参数绑定：)
  - [3.3 复杂对象参数：](#3.3 复杂对象参数：)
- [4 异步命令实现](#4 异步命令实现)
- [5 常见问题排查](#5 常见问题排查)

WPF的命令系统是MVVM模式中实现业务逻辑与UI交互的核心机制。本章将深入解析 ICommand接口的实现原理，并提供企业级应用中的最佳实践方案。

1 RelayCommand实现

通过自定义命令类解耦UI与业务逻辑：

基础实现模板：

csharp 复制代码

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中的使用示例：

csharp 复制代码

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绑定示例：

xml 复制代码

<Button Content="保存" 
        Command="{Binding SaveCommand}"
        IsEnabled="{Binding SaveCommand.IsEnabled}"/>

动态更新策略：

自动更新（默认）：

csharp 复制代码

// 通过CommandManager自动触发
CommandManager.InvalidateRequerySuggested();

手动通知：

csharp 复制代码

// 在属性变更时触发
public string Content
{
    set 
    {
        _content = value;
        OnPropertyChanged();
        SaveCommand.RaiseCanExecuteChanged();
    }
}

禁用状态样式优化：

xml 复制代码

<Style TargetType="Button">
    <Style.Triggers>
        <Trigger Property="IsEnabled" Value="False">
            <Setter Property="Opacity" Value="0.5"/>
        </Trigger>
    </Style.Triggers>
</Style>

3 参数传递（CommandParameter）

支持多种参数传递方式：

3.1 静态参数绑定：

xml 复制代码

<Button Command="{Binding StatusCommand}" 
        CommandParameter="Approved"/>

3.2 动态参数绑定：

xml 复制代码

<ComboBox x:Name="statusList" SelectedValuePath="Tag"/>
<Button Command="{Binding UpdateCommand}" 
        CommandParameter="{Binding SelectedItem.Tag, ElementName=statusList}"/>

3.3 复杂对象参数：

csharp 复制代码

// ViewModel
public RelayCommand<User> EditCommand { get; } = 
    new RelayCommand<User>(user => /* 编辑逻辑 */);

xml 复制代码

// 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 异步命令实现

处理长时间运行任务的最佳实践：

异步命令模板：

csharp 复制代码

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;
    }
}

使用示例：

csharp 复制代码

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调用：

csharp 复制代码

Application.Current.Dispatcher.Invoke(CommandManager.InvalidateRequerySuggested);

问题3：参数绑定失败

使用调试转换器检查参数值：

xml 复制代码

<Button CommandParameter="{Binding SelectedItem, Converter={local:DebugConverter}}"/>

确认参数类型与命令泛型类型匹配

问题4：内存泄漏

及时取消命令订阅：

csharp 复制代码

public void Dispose()
{
    SaveCommand.CanExecuteChanged -= OnSaveCommandChanged;
}

本章小结

通过本章学习，开发者应掌握：

实现符合生产标准的RelayCommand
通过CanExecute控制UI状态
多种参数传递模式的应用
异步命令的安全实现
常见命令问题的诊断方法

建议实践以下场景：

开发带撤销/重做功能的编辑器
实现分页数据加载命令
创建支持多选操作的批量处理命令

下一章将深入讲解MVVM模式的核心架构与实现细节。