DevExpress WPF v21.1版本针对WPF产品线增强了一系列与MVVM相关的功能,这些增强功能使在 ViewModel 级别处理控制事件变得更加容易(您可以看到,技术团队添加了多个命令属性和多占的EventToCommand 操作功能)。
在以前的版本中,可以通过以下方式在 ViewModel 中处理事件:
- 使用EventToCommand操作来执行命令以响应引发的事件。
- 使用DXEvent机制将事件绑定到 ViewModel 方法。
这些技术不允许您指定返回值(例如,如果您需要为 ValidateCell 事件设置 e.IsValid),以前的版本要求您编写复杂的操作或将与UI相关的事件参数传递给您的ViewModel。
从v21.1开始,技术团队解决了这个限制并在几个方面扩展了MVVM 支持。
WPF数据网格中的新命令API
在v21.1版本中,包含了多个旨在将ViewModel 的命令绑定到控件的属性,这些属性是期望返回值的WPF Data Grid事件的命令对应项:
ValidateRow event -> ValidateRowCommand property
CustomColumnDisplayText event -> CustomColumnDisplayTextCommand property
您不再需要编写特殊的转换器,ViewModel 获得一个类型化的参数,该参数公开了与 UI 无关的事件参数,您可以在 ViewModel 级别修改此参数并将值返回给事件。考虑以下示例,其中WPF数据网格使用命令自定义单元格值:
<dxg:GridControl CustomColumnDisplayTextCommand="{Binding CalculateDisplayTextCommand}"/>
public class ViewModel: ViewModelBase { // ... [Command] public void CalculateDisplayText(ColumnDisplayTextArgs e) { if (e.FieldName == "Value") e.DisplayText = string.Format("{0:n2}", e.Value); } }
虚拟源中的新命令API
您可能知道,虚拟源的早期版本只能使用事件处理程序来实现数据操作。DevExpress官方收到了许多改进建议,要求改进ViewModel 级别的事件处理,从v21.1版本开始,您只需在 XAML 中声明一个虚拟源并绑定其新命令属性即可在 ViewModel 级别处理这些事件:
<dxg:GridControl.ItemsSource> <dxg:InfiniteAsyncSource ElementType="{x:Type local:IssueData}" FetchRowsCommand="{Binding FetchIssuesCommand}" GetTotalSummariesCommand="{Binding GetTotalSummariesCommand}" GetUniqueValuesCommand="{Binding GetUniqueValuesCommand}"> </dxg:InfiniteAsyncSource> </dxg:GridControl.ItemsSource>
您可以在 ViewModel 级别合并数据操作,而无需引入 UI 依赖项。 命令参数公开了一个独立于平台的 API,允许您将数据从 ViewModel 传递到数据网格:
public class ViewModel : ViewModelBase { // ... [Command] public void FetchIssues(DevExpress.Mvvm.Xpf.FetchRowsAsyncArgs args) { args.Result = GetIssuesAsync(args); } }
EventToCommand - 事件参数返回转换
如果要处理没有命令属性的事件,可以使用 EventToCommand操作并手动将命令绑定到事件。
我们扩展了 EventToCommand 功能以允许您定义反向转换逻辑,当您将事件参数传递给命令时,可以修改它们并根据需要将值返回给事件:
<dxe:TextEdit EditValue="{Binding UserName}"> <dxmvvm:Interaction.Behaviors> <dxmvvm:EventToCommand Command="{Binding UserNameValidationCommand}" EventArgsConverter="{local:ValidateEventArgsConverter}" EventName="Validate"/> </dxmvvm:Interaction.Behaviors> </dxe:TextEdit>
public class ValidationArgs { public string ErrorContent { get; private set; } public object Value { get; } public ValidationArgs(object value) => Value = value; public void SetError(bool isValid, string errorContent) => ErrorContent = isValid ? null : errorContent; } public class ValidateEventArgsConverter: EventArgsConverterBase<ValidationEventArgs> { protected override object Convert(object sender, ValidationEventArgs e) => new ValidationArgs(e.Value); protected override void ConvertBack(object sender, ValidationEventArgs e, object parameter) { var args = parameter as ValidationArgs; e.IsValid = args.ErrorContent == null; e.ErrorContent = args.ErrorContent; } }
DevExpress WPF拥有120+个控件和库,将帮助您交付满足甚至超出企业需求的高性能业务应用程序。通过DevExpress WPF能创建有着强大互动功能的XAML基础应用程序,这些应用程序专注于当代客户的需求和构建未来新一代支持触摸的解决方案。 无论是Office办公软件的衍伸产品,还是以数据为中心的商业智能产品,都能通过DevExpress WPF控件来实现。
DevExpress技术交流群6:600715373 欢迎一起进群讨论