我是WPF编程环境的新手。我正在尝试使用MVVM设计模式编写一个程序。
我做了一些研究,读了一些与之相关的文章,很多时候我都会遇到这种叫做的东西
ViewModelBase
我知道它是什么。但是我可以具体地知道我应该从哪里开始才能写出我自己的ViewModelBase吗?喜欢真正理解正在发生的事情,而不会变得太复杂。谢谢:)
如果你不知道里面发生了什么,那么使用MVVM框架毫无价值。
因此,让我们逐步构建您自己的ViewModelBase类。
-
ViewModelBase是所有视图模型的公共类。让我们把所有通用逻辑移到这个类中。
-
您的ViewModels应该实现
INotifyPropertyChanged
(您明白为什么吗?)public abstract class ViewModelBase : INotifyPropertyChanged { public event PropertyChangedEventHandler PropertyChanged; protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null) { PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)); } }
[CallerMemberName]
属性不是必需的,但它允许您写入:OnPropertyChanged();
而不是OnPropertyChanged("SomeProperty");
,因此您将在代码中避免字符串常量。示例:public string FirstName { set { _firstName = value; OnPropertyChanged(); //instead of OnPropertyChanged("FirstName") or OnPropertyChanged(nameof(FirstName)) } get{ return _firstName;} }
请注意,不再推荐使用
OnPropertyChanged(() => SomeProperty)
,因为我们在C#6中有nameof
运算符。 -
实现这样调用PropertyChanged的属性是常见的做法:
public string FirstName { get { return _firstName; } set { SetProperty(ref _firstName, value); } }
让我们在视图模型库中定义SetProperty:
protected virtual bool SetProperty<T>(ref T storage, T value, [CallerMemberName] string propertyName = "") { if (EqualityComparer<T>.Default.Equals(storage, value)) return false; storage = value; this.OnPropertyChanged(propertyName); return true; }
它只是在属性值更改时触发
PropertyChanged
事件并返回true。当值没有更改时,它不会激发事件,并返回false。基本思想是,SetProperty
方法是虚拟的,您可以在更具体的类中扩展它,例如触发验证,或者通过调用PropertyChanging
事件。
这太棒了。这是ViewModelBase在此阶段应该包含的全部内容。剩下的取决于你的项目。例如,您的应用程序使用基于页面的导航,并且您已经编写了自己的NavigationService来处理ViewModel中的导航。因此,您可以将NavigationService属性添加到ViewModelBase类中,这样您就可以从所有视图模型中访问它(如果需要的话)。
为了获得更多的可重用性并保持SRP,我有一个名为BindableBase的类,它几乎是我们在这里所做的INotifyPropertyChanged的实现。我在每个WPF/UWP/Silverligt/WindowsPhone解决方案中都重用这个类,因为它是通用的。
然后在每个项目中,我都创建了从BindableBase:派生的自定义ViewModelBase类
public abstract ViewModelBase : BindableBase
{
//project specific logic for all viewmodels.
//E.g in this project I want to use EventAggregator heavily:
public virtual IEventAggregator () => ServiceLocator.GetInstance<IEventAggregator>()
}
如果我有一个应用程序,它使用基于页面的导航,我还为页面视图模型指定基类。
public abstract PageViewModelBase : ViewModelBase
{
//for example all my pages have title:
public string Title {get; private set;}
}
我可以有另一个对话框类:
public abstract DialogViewModelBase : ViewModelBase
{
private bool? _dialogResult;
public event EventHandler Closing;
public string Title {get; private set;}
public ObservableCollection<DialogButton> DialogButtons { get; }
public bool? DialogResult
{
get { return _dialogResult; }
set { SetProperty(ref _dialogResult, value); }
}
public void Close()
{
Closing?.Invoke(this, EventArgs.Empty);
}
}
以下类可以用作WPF项目中的ViewModelBase:
public abstract class ViewModelBase : INotifyPropertyChanged
{
/// <summary>
/// Multicast event for property change notifications.
/// </summary>
public event PropertyChangedEventHandler PropertyChanged;
/// <summary>
/// Checks if a property already matches the desired value. Sets the property and
/// notifies listeners only when necessary.
/// </summary>
/// <typeparam name="T">Type of the property.</typeparam>
/// <param name="storage">Reference to a property with both getter and setter.</param>
/// <param name="value">Desired value for the property.</param>
/// <param name="propertyName">Name of the property used to notify listeners.This
/// value is optional and can be provided automatically when invoked from compilers that
/// support CallerMemberName.</param>
/// <returns>True if the value was changed, false if the existing value matched the
/// desired value.</returns>
protected virtual bool SetProperty<T>(ref T storage, T value, [CallerMemberName] string propertyName = null)
{
if (object.Equals(storage, value)) return false;
storage = value;
// Log.DebugFormat("{0}.{1} = {2}", this.GetType().Name, propertyName, storage);
this.OnPropertyChanged(propertyName);
return true;
}
/// <summary>
/// Notifies listeners that a property value has changed.
/// </summary>
/// <param name="propertyName">Name of the property used to notify listeners. This
/// value is optional and can be provided automatically when invoked from compilers
/// that support <see cref="CallerMemberNameAttribute"/>.</param>
protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
{
var eventHandler = this.PropertyChanged;
if (eventHandler != null)
eventHandler(this, new PropertyChangedEventArgs(propertyName));
}
}
ViewModel类的一个例子是:
public class MyViewModel : ViewModelBase
{
private int myProperty;
public int MyProperty
{
get { return myProperty; }
set { SetProperty(ref myProperty, value); }
}
}
为了便于编写,可以使用以下代码段:
<?xml version="1.0" encoding="utf-8"?>
<CodeSnippets
xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">
<Header>
<Title>OnPropertyChanged</Title>
</Header>
<Snippet>
<SnippetTypes>
<SnippetType>SurroundsWith</SnippetType>
<SnippetType>Expansion</SnippetType>
</SnippetTypes>
<Declarations>
<Literal>
<ID>TYPE</ID>
<ToolTip>Property type</ToolTip>
<Default>int</Default>
</Literal>
<Literal>
<ID>NAME1</ID>
<ToolTip>Property name</ToolTip>
<Default>MyProperty</Default>
</Literal>
</Declarations>
<Code Language="CSharp">
<![CDATA[private $TYPE$ _$NAME1$;
public $TYPE$ $NAME1$
{
get => _$NAME1$;
set => SetProperty(ref _$NAME1$, value);
}]]>
</Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>
完整的代码可以从这里下载。
您有一些nuget包来实现MVVM
- MVVM灯
- MVVM交叉
- 棱镜
对我来说,对于初学者来说更容易的是MVVM轻量级,因为它提供了一些代码示例。
因此,最好安装这个nuget包,查看生成的代码,如果需要,可以返回我们获取更多解释。
在大多数MVVM框架中,基本ViewModel类实际上只包含很少的代码-通常只是INotifyPropertyChanged和一些辅助函数的实现。
查看MVVM Light的ViewModelBase和ObservableObject类的源代码。ObservableObject主要是INotifyPropertyChanged实现——使用lambda表达式而不是"魔术字符串"作为属性名称。ViewModelBase扩展了ObservableObject,主要是一种实用方法,用于确定您是否在Visual Studio设计器中运行
我喜欢这个BaseVewModel,它为您的视图模型提供了一种很好的干净风格。查看各种"之前"one_answers"之后"的比较。当然,没有什么是强制性的-如果你不喜欢BaseViewModel提供的功能,就不要使用它。或者因为你有源代码而修改它。特别要注意的是,有三种不同的方法可以通过更改通知来实现属性-选择您理解/感到满意的复杂程度。
今天要重新讨论这个答案,我想在为Visual Studio编写MVVM代码时提供额外的生产力改进。
Visual Studio中的Intellisense可以自动创建SetProperty
样板方法。为此,我在Window的XAML中设置了ViewModel(请参见下文)。然后,每当我引用{Binding Path=NewProperty}
时,右键单击并选择Quick Actions and Refactoring...
(或通过Ctrl .
)。如果没有创建SetProperty
方法,它将在ViewModel类中自动为您创建。此外,它将生成绑定所需的属性和字段。
<Window x:Class="My.Project.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:local="clr-namespace:My.Project"
mc:Ignorable="d"
xmlns:viewmodel="clr-namespace:My.Project.ViewModels" d:DataContext="{d:DesignInstance Type=viewmodel:MainWindowViewModel}"
Title="MainWindow" Height="360" Width="1000">
...
</Window>
然而,这种方法有缺点
INotifyPropertyChanged
未实现,OnPropertyChanged
方法未实现(如果需要)- 这需要在每个ViewModel中完成
- 这是特定于Visual Studio的
优点:
- 一旦在项目中定义了
SetProperty
方法,使用Quick Actions and Refactoring...
选项将只为您生成必要的属性和字段。如果从ViewModelBase
继承,这也适用
以下是Visual Studio生成的SetProperty
方法。
protected virtual bool SetProperty<T>(ref T storage, T value, [CallerMemberName] string propertyName = null)
{
if (object.Equals(storage, value)) return false;
storage = value;
// Log.DebugFormat("{0}.{1} = {2}", this.GetType().Name, propertyName, storage);
this.OnPropertyChanged(propertyName);
return true;
}
using System;
using System.Collections.Generic;
using System.Text;
using System.Threading.Tasks;
using Xamarin.Forms;
using System.Runtime.CompilerServices;
using System.ComponentModel;
namespace CollectionViewMVVM.ViewModel
{
public class BaseViewModel : INotifyPropertyChanged
{
/*Referencia: https://www.youtube.com/watch?v=PXEt1esjnZ0&ab_channel=Codigo369*/
public INavigation Navigation;
public event PropertyChangedEventHandler PropertyChanged;
public virtual void OnpropertyChanged([CallerMemberName] string nombre = "")
{
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nombre));
}
private ImageSource foto;
public ImageSource Foto
{
get { return foto; }
set
{
foto = value;
OnpropertyChanged();
}
}
protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
{
PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
}
public async Task DisplayAlert(string title, string message, string cancel)
{
await Application.Current.MainPage.DisplayAlert(title, message, cancel);
}
public async Task<bool> DisplayAlert(string title, string message, string accept, string cancel)
{
return await Application.Current.MainPage.DisplayAlert(title, message, accept, cancel);
}
protected bool SetProperty<T>(ref T field, T value, [CallerMemberName] string propertyName = null)
{
if(EqualityComparer<T>.Default.Equals(field, value))
{
return false;
}
field = value;
OnPropertyChanged(propertyName);
return true;
}
/*Ejemplo para declarar entrys*/
private string _title;
public string Title
{
get { return _title; }
set
{
SetProperty(ref _title, value);
}
}
/*Para tipos bool*/
private bool _isBusy;
public bool IsBusy
{
get { return _isBusy; }
set
{
SetProperty(ref _isBusy, value);
}
}
protected void SetValue<T>(ref T backingFielded, T value, [CallerMemberName] string propertyName = null)
{
if(EqualityComparer<T>.Default.Equals(backingFielded, value))
{
return;
}
backingFielded = value;
OnPropertyChanged(propertyName);
}
}
}