找回密码
 立即注册
首页 业界区 业界 理解WPF Stylet中Command="{s:Action 方法名}"的设计与 ...

理解WPF Stylet中Command="{s:Action 方法名}"的设计与实现

石娅凉 2025-10-1 19:10:01
前言

Stylet是我最近很喜欢使用的一个WPF框架,它的很多设计都体现了约定优于配置的思想。因此你会发现使用它非常方便,几乎不需要任何配置,开箱即用,只需知道它的一些约定即可。
查看Samples中Hello这个例子,只要在xaml中这样写:
  1. <Button Command="{s:Action SayHello}">Say Hello</Button>
复制代码
然后你点击这个按钮,就会触发对应ViewModel中的SayHello方法,使用起来非常简单方便。这背后Stylet框架做了什么呢?让我们揭开它的神秘面纱吧!!
ActionExtension

先来看看ActionExtension,它位于Stylet.Xaml命名空间:
1.png

s:Action的第一阶段是XAML解析,这个阶段的核心任务是将XAML标记中的{s:Action SayHello}语法翻译成CommandAction实例。这个过程由ActionExtension标记扩展类完成,它是整个命令绑定系统的入口点。
当XAML解析器遇到{s:Action SayHello}时,会调用ActionExtension.ProvideValue方法:
2.png

HandleDependencyObject方法根据目标属性的类型进行分支处理:
3.png

对于命令绑定场景,CreateCommandAction方法创建CommandAction实例:
4.png

rootObject就是具有s:Action的页面:
5.png

View.ActionTarget

现在我们已经找到了View,但是想要触发的方法是在ViewModel上的,那么就要想办法找到对应的ViewModel,Stylet中是通过View.ActionTarget这个附加属性实现的。通过View.ActionTarget附加属性将ViewModel注入到可视化树中,使得后续阶段能够找到正确的命令执行目标。
先来看看View.ActionTarget的定义,位置在命名空间Stylet.Xaml下的View类中:
6.png

默认值:InitialActionTarget(一个特殊的标记对象)
继承性:FrameworkPropertyMetadataOptions.Inherits确保属性值可以沿着可视化树向下传递
当View.Model属性被设置时,会触发PropertyChangedCallback,通过ViewManager建立视图和ViewModel的关联。
7.png

在将View与ViewModel关联起来的时候,设置了当前View的ActionTarget为对应的ViewModel。
CommandAction

8.png

在CreateCommandAction方法中会返回一个CommandAction。
9.png

这里是在把当前这个Subject对象里的ActionTargetProperty的值‘拴’到 某个尚未显式的目标属性上,而且只让它从源(Subject)流向目标,不会反向同步。
这里的Subject是Button对象,为什么也能找到ActionTargetProperty这个属性呢?
由于ActionTargetProperty设置了FrameworkPropertyMetadataOptions.Inherits标志,这个属性会自动沿着可视化树向下传播:
  1. Window (View.ActionTargetProperty)
  2. ├── UserControl (继承Window的View.ActionTargetProperty)
  3. │   ├── Button (继承UserControl的View.ActionTargetProperty)
  4. │   └── TextBox (继承UserControl的View.ActionTargetProperty)
  5. └── Grid (继承Window的View.ActionTargetProperty)
复制代码
但是现在还没完成绑定,只是绑定的一端,还需要设置将这个属性绑定到哪里。
10.png

BindingOperations.SetBinding(this, targetProperty, multiBinding);将ActionBase的targetProperty依赖属性绑定到View.ActionTargetProperty。
11.png

你会发现现在并没有绑定到ViewModel,只是View.ActionTargetProperty的默认值:
12.png

由于targetProperty依赖属性从null到View.InitialActionTarget也会触发UpdateActionTarget,不过这一次不做任何处理,直接返回:
13.png

当设置View.ActionTargetProperty的值为对应的ViewModel时:
14.png

就又会触发UpdateActionTarget方法,这一次拿到了对应的ViewModel:
15.png

拿到ViewModel上的方法:
16.png

拿到是否可以执行对应命令的属性:
17.png

现在重点来关注一下这里:
  1. Expressions.ConstantExpression targetExpression = Expressions.Expression.Constant(newTarget);
  2. Expressions.MemberExpression propertyAccess = Expressions.Expression.Property(targetExpression, guardPropertyInfo);
  3. this.guardPropertyGetter = Expressions.Expression.Lambda<Func<bool>>(propertyAccess).Compile();
复制代码
这段代码在运行时动态编译一段表达式树,生成一个无参、返回 bool的委托(Func),用来快速读取某个对象的布尔型属性值。
第一行相当于就是使用这个newTarget对象,第二行就是访问这个newTarget对象的CanSayHello属性,相当于newTarget.CanSayHello。
Expression.Lambda将表达式树包装成一个无参Lambda表达式(形如 () => newTarget.CanSayHello)。
.Compile()把表达式树编译成可执行IL ,生成一个静态缓存的委托Func。
然后调用this.UpdateCanExecute();触发CanExecuteChanged事件,就会执行CanExecute方法,在这个方法中就使用到了刚刚生成的获取newTarget.CanSayHello属性的委托:
18.png

现在是false,命令无法执行:
19.png

当我输入小明的时候就修改了这个属性值,就会触发CanExecuteChanged事件:
20.png

就又会调用刚刚生成的那个获取newTarget.CanSayHello属性的委托:
21.png

这一次返回true,命令可以执行。
当我点击按钮的时候,如果命令可以执行,就会执行Execute方法
22.png

这样就会执行ViewModel中对应的方法。
以上就是个人对于WPF Stylet中Command="{s:Action SayHello}"的设计与实现的理解。

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

相关推荐

您需要登录后才可以回帖 登录 | 立即注册