DevExpress WPF入门指南 - 运行时生成的POCO视图模型(二)
POCO(Plain Old CLR Objects)视图模型简化并加快了开发过程。
POCO 视图模型允许您:
- 将可绑定属性定义为简单的自动实现的属性。
- 创建在运行时用作命令的方法。
- 使属性和方法实现特定于 MVVM 的接口。
这允许您创建干净、简单、可维护和可测试的 MVVM 代码,POCO 视图模型与任何 WPF 控件完全兼容。
您可以使用在编译时生成的视图模型在编译时为您的视图模型生成样板代码。
可绑定属性
POCO 机制为满足以下所有要求的属性生成可绑定属性:
- 该属性是公共的并且是自动实现的。
- 该属性具有virtual (C#) 或 Overridable (VB) 修饰符。
- 该属性有一个公共的 getter,以及一个受保护的或公共的 setter。
如果属性没有setter,则可以使用 RaisePropertyChanged 扩展方法显式引发该属性的 PropertyChanged 事件。
您可以定义在属性更改时调用的方法,这些方法名称应使用以下格式:On[PropertyName]Changed 和 On[PropertyName]Changing。
C#
public class LoginViewModel {
public virtual string UserName { get; set; }
protected void OnUserNameChanged() {
//...
}
}
public class LoginViewModel {
public virtual string UserName { get; set; }
protected void OnUserNameChanged(string oldValue) {
//...
}
protected void OnUserNameChanging(string newValue) {
//...
}
}
您可以使用 BindableProperty 属性来:
- 防止 POCO 机制为指定属性生成可绑定属性;
- 指定当属性值正在更改或已更改时应调用的方法,当方法的名称与 On[PropertyName]Changed 和 On[PropertyName]Changing 约定不匹配时,这很有用。
C#
public class LoginViewModel {
[BindableProperty(isBindable: false)]
public virtual bool IsEnabled { get; set; }
[BindableProperty(OnPropertyChangedMethodName = "Update")]
public virtual string UserName { get; set; }
protected void Update() {
//...
}
}
您可以使用 Fluent API 来控制 POCO ViewModel 的生成。
C#
[MetadataType(typeof(Metadata))]
public class LoginViewModel {
public class Metadata : IMetadataProvider<LoginViewModel> {
void IMetadataProvider<LoginViewModel>.BuildMetadata
(MetadataBuilder<LoginViewModel> builder) {
builder.Property(x => x.UserName).
OnPropertyChangedCall(x => x.Update());
builder.Property(x => x.IsEnabled).
DoNotMakeBindable();
}
}
public virtual bool IsEnabled { get; set; }
public virtual string UserName { get; set; }
protected void Update() {
//...
}
}
命令
POCO 机制为所有没有参数或单个参数的公共方法生成命令,生成的命令名称遵循 [MethodName]Command 模式,您可以使用 Command 属性或 Fluent API 来控制命令生成机制。
C#
public class LoginViewModel {
[Command(isCommand: false)]
public void SaveCore() {
//...
}
[Command(CanExecuteMethodName = "CanSaveAccountSettings",
Name = "SaveCommand",
UseCommandManager = true)]
public void SaveAccountSettings(string fileName) {
//...
}
public bool CanSaveAccountSettings(string fileName) {
return !string.IsNullOrEmpty(fileName);
}
}
[MetadataType(typeof(Metadata))]
public class LoginViewModel {
public class Metadata : IMetadataProvider<LoginViewModel> {
void IMetadataProvider<LoginViewModel>.BuildMetadata(MetadataBuilder<LoginViewModel> builder) {
builder.CommandFromMethod(x => x.SaveCore()).
DoNotCreateCommand();
builder.CommandFromMethod(x => x.SaveAccountSettings(default(string))).
CanExecuteMethod(x => x.CanSaveAccountSettings(default(string))).
CommandName("SaveCommand");
}
}
public void SaveCore() {
//...
}
public void SaveAccountSettings(string fileName) {
//...
}
public bool CanSaveAccountSettings(string fileName) {
return !string.IsNullOrEmpty(fileName);
}
}
要更新 POCO 视图模型中自动生成的命令,请使用 DevExpress.Mvvm.POCO.POCOViewModelExtensions 类中提供的 RaiseCanExecuteChanged 扩展方法。
C#
[POCOViewModel]
public class ViewModel {
public void GoBack(){
//...
}
public bool CanGoBack(){
//...
}
public void UpdateSaveCommand(){
this.RaiseCanExecuteChanged(c => c.GoBack());
}
}
DevExpress WPF拥有120+个控件和库,将帮助您交付满足甚至超出企业需求的高性能业务应用程序。通过DevExpress WPF能创建有着强大互动功能的XAML基础应用程序,这些应用程序专注于当代客户的需求和构建未来新一代支持触摸的解决方案。 无论是Office办公软件的衍伸产品,还是以数据为中心的商业智能产品,都能通过DevExpress WPF控件来实现。
DevExpress技术交流群6:600715373 欢迎一起进群讨论
浙公网安备 33010602011771号