WPF 的命令的自动刷新时机——当你 CanExecute 会返回 true 但命令依旧不可用时可能是这些原因

在 WPF 中，你可以使用 Command="{Binding WalterlvCommand}" 的方式来让 XAML 中的一个按钮或其他控件绑定一个命令。这样，按钮的可用性会自动根据 WalterlvCommand 当前 CanExecute 的状态来改变。这本是一个非常智能的特性，直到你可能发现你按钮的可用性状态不正确……

本文介绍默认情况下，WPF 在 UI 上的这些命令会在什么时机进行刷新；以及没有及时刷新时，可以如何强制让这些命令的可用性状态进行刷新。了解了这些，你可能能够解决你在 WPF 程序中命令绑定的一些坑。

This post is written in multiple languages. Please select yours:

• WPF 的命令的自动刷新时机——当你 CanExecute 会返回 true 但命令依旧不可用时可能是这些原因 - walterlv
• When WPF Commands update their CanExecute states? - walterlv

一个最简单的例子

Button x:Name="TestCommand" Command="{Binding WalterlvCommand}" />

• 1

public class Walterlv
{
    // 省略了此命令的初始化。
    public WalterlvCommand WalterlvCommand { get; }
}

public class WalterlvCommand : ICommand
{
    public bool SomeFlag { get; set; }

    bool ICommand.CanExecute(object parameter)
    {
        // 判断命令的可用性。
        return SomeFlag;
    }

    void ICommand.Execute(object parameter)
    {
        // 省略了执行命令的代码。
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21

假如 SomeFlag 一开始是 false，5 秒种后变为 true，那么你会注意到这时的按钮状态并不会刷新。

var walterlv = new Walterlv();
TestCommand.DataContext = walterlv;

await Task.Delay(5000);
walterlv.WalterlvCommand.SomeFlag = true;

• 1
• 2
• 3
• 4
• 5

当然，以上所有代码会更像伪代码，如果你不熟悉 WPF，是一定编译不过的。我只是在表达这个意思。

如何手动刷新命令

调用以下代码，即可让 WPF 中的命令刷新其可用性：

CommandManager.InvalidateRequerySuggested();

• 1

WPF 的命令在何时刷新？

默认情况下，WPF 的命令只会在以下时机刷新可用性：

• KeyUp
• MouseUp
• GotKeyboardFocus
• LostKeyboardFocus

使用通俗的话来说，就是：

• 键盘按下的按键抬起的时候
• 在鼠标的左键或者右键松开的时候
• 在任何一个控件获得键盘焦点或者失去键盘焦点的时候

这部分的代码可以在这里查看：

• CommandDevice.PostProcessInput

最关键的代码贴在这里：

// 省略前面。
if (e.StagingItem.Input.RoutedEvent == Keyboard.KeyUpEvent ||
    e.StagingItem.Input.RoutedEvent == Mouse.MouseUpEvent ||
    e.StagingItem.Input.RoutedEvent == Keyboard.GotKeyboardFocusEvent ||
    e.StagingItem.Input.RoutedEvent == Keyboard.LostKeyboardFocusEvent)
{
    CommandManager.InvalidateRequerySuggested();
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8

然而，并不是只在这些时机进行刷新，还有其他的时机，比如这些：

• 在 Menu 菜单的子菜单项打开的时候（参见 MenuItem.OnIsSubmenuOpenChanged）
• 在长按滚动条中的按钮以连续滚动的过程中（参见 Tracker.DecreaseRepeatButton）
• 在 DataGridCell 的只读属性改变的时候（参见 DataGridCell.OnNotifyIsReadOnlyChanged）
• 在 DataGrid 中的各种各样的操作中（参见 DataGrid）
• 在 JournalNavigationScope 向后导航的时候（参见 JournalNavigationScope.OnBackForwardStateChange）
• 还有其他，你可以在此链接双击 InvalidateRequerySuggested 查看：InvalidateRequerySuggested

我的博客会首发于 https://blog.walterlv.com/，而 CSDN 会从其中精选发布，但是一旦发布了就很少更新。

如果在博客看到有任何不懂的内容，欢迎交流。我搭建了 dotnet 职业技术学院 欢迎大家加入。

本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。欢迎转载、使用、重新发布，但务必保留文章署名吕毅（包含链接：https://walterlv.blog.csdn.net/），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请与我联系。