如在阅读本文后,后续遇到文中没有提及的问题或知识点,可以查看源码说明文档
1.首先添加PropertyChanged.Fody的Nuget程序包
PM> Install-Package Fody
PM> Install-Package PropertyChanged.Fody
2.再者添加FodyWeavers.xml 文件
一般安装完PropertyChanged.Fody程序包后,会自动创建FodyWeavers.xml 文件;如果没有自动创建FodyWeavers.xml 文件,此时我们可以重新生成项目,然后项目生成时会自动在项目根目录下创建FodyWeavers.xml 文件,此时还没有包括在项目中,我们需要先显示所有文件,然后将FodyWeavers.xml 文件包含在项目中即可。如果以上操作均没有生成FodyWeavers.xml 文件,则自行在项目中创建FodyWeavers.xml 文件,然后在文件中,配置如下代码:
<Weavers>
<PropertyChanged/>
Weavers>
当我们介绍完安装完程序包后,下面就需介绍如何使用该程序包中提供的功能。
PropertyChanged.Fody的核心功能就是提供了一系列的特性供我们使用,通过给属性和类上标注特性,是我们的代码更加的简洁
通常我们自己手动实现INotifyPropertyChanged接口后,会需要将我们自己的ViewModel继承自实现类,然后在属性中调用方法来实现属性通知。如下示例中,ViewModelBase为自行实现INotifyPropertyChanged接口的实现类:
public class MainViewModel:ViewModelBase
{
private double _num;
public double Num
{
get { return _num; }
set { _num = value; OnPropertyChanged(); }
}
}
当我们使用了PropertyChanged.Fody插件后,可通过以下方式来实现一样的功能
方式1 示例代码:
public class MainViewModel : INotifyPropertyChanged
{
public double Num { get; set; }
public event PropertyChangedEventHandler PropertyChanged;
}
方式2示例代码:
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
public double Num { get; set; }
}
以上两种方式作用是一样的,都可以实现属性通知,并且还可以使我们属性通知的代码量大大的减少,编码界面更为简洁清晰。
下面我们通过一个完整的案例了解一下具体的使用,案例中实现Num1+Num2=Total:
<>OnPropertyChanged(<>PropertyChangedEventArgs.Total);
这样的一句代码,表示Num1和Num2属性更新后,不仅会通知自身,还会通知Total。注意:只有在类上标注AddINotifyPropertyChangedInterface特性或者实现INotifyPropertyChanged接口后,PropertyChanged.Fody中其他的特性才能生效,否则其他特性单独使用是无效的。
通过AlsoNotifyFor特性,我们可以实现在通知自身属性的时候,通知其他的属性进行更新;
实现原理:也仅仅是使用了该特性后,set访问器中会自动插入对应属性的属性通知代码
通过下图的源代码和反编译代码对比图可以加以佐证:
另外建议使用nameof去配置需要 另外通知的属性名,不容易出现低级错误;再者可以通过逗号配置多个需要另外通知的属性。
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
[AlsoNotifyFor(nameof(Total),nameof(Num2))]
public double Num1 { get; set; }
public double Num2 { get; set; }
public double Total { get; set; }
}
如果ViewModel中的某一些属性,我们并不希望其具有属性通知的功能,可以使用DoNotNotify特性。
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
[DoNotNotify]
public double Num1 { get; set; }
public double Num2 { get; set; }
public double Total { get; set; }
}
默认情况下:如果有一个属性为Num,有一个方法为 OnNumChanged方法,那么在Num属性值更新的时候,就会执行OnNumChanged方法,只要是方法符合以上命名规则,就会自动生成调用代码。
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
//在Num1更新时,自动调用OnNum1Changed方法
public double Num1 { get; set; }
public double Num2 { get; set; }
public double Total { get; set; }
private void OnNum1Changed()
{
Total = Num1 + Num2;
}
}
但是,如果我们向明确的指定属性更改时需要调用的方法,则需通过OnChangedMethod特性。
通过下图了解OnChangedMethod特性的原理,原理很简单就是在set访问器中调用特性中配置的方法。
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
[OnChangedMethod(nameof(OnNumChanged))]
public double Num1 { get; set; }
[OnChangedMethod(nameof(OnNumChanged))]
public double Num2 { get; set; }
public double Total { get; set; }
private void OnNumChanged()
{
Total = Num1 + Num2;
}
}
以上案例表示当Num1和Num2 更新的时候,就执行OnNumChanged这个方法计算数字和。
我们知道当我们给属性添加了AlsoNotifyFor特性的时候,可以实现在通知自身属性的时候,通知其他的属性进行更新;但是如果多个属性都通过AlsoNotifyFor指向的是同一个属性的时候,逐个添加不免有些麻烦;此时我们就可以使用DependsOn 特性,统一在最终指向的属性上,设置其依赖的属性即可。
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
public double Num1 { get; set; }
public double Num2 { get; set; }
[DependsOn(nameof(Num1),nameof(Num2))]
public double Total { get; set; }
}
默认情况下,所有属性通知中都会检查属性值是否相等,如果属性值相等,则不会进行通知;原理代码如下:
public string Property1
{
get
{
return property1;
}
set
{
if (!String.Equals(property1, value))
{
property1 = value;
OnPropertyChanged("Property1");
}
}
}
但在某些情况下,我们需要无论是否相等都会进行通知,这个时候,可以在属性上标记DoNotCheckEquality特性以跳过是否相等的检查。
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
[DoNotCheckEquality]
public double Num1 { get; set; }
public double Num2 { get; set; }
public double Total { get; set; }
}
当我们给属性加上DoNotCheckEquality特性的时候,就相当于给去掉了Object.Equals()
这个判断。
如果在添加了AddINotifyPropertyChangedInterface特性或者实现INotifyPropertyChanged接口的实现类中,有一个属性是IsChanged属性,那么默认情况下,当前类中的所有属性只要发生变化,都会将IsChanged 的属性值设置为True;
public bool IsChanged { get; set; }
如果希望在某个属性变化时,不设置IsChanged的属性值,可以给属性添加DoNotSetChanged特性,如下所示:
[AddINotifyPropertyChangedInterface]
public class MainViewModel
{
public bool IsChanged { get; set; }
public double Num1 { get; set; }
public double Num2 { get; set; }
[DoNotSetChanged]
public double Total { get; set; }
}
该配置用于更改激发属性通知事件的方法名称,这是一个以逗号分隔形式接受多个值的字符串。默认值为:
<Weavers>
<PropertyChanged EventInvokerNames="OnPropertyChanged, NotifyOfPropertyChange, RaisePropertyChanged, NotifyPropertyChanged, NotifyChanged"/>
Weavers>
默认值覆盖了WPF中大多数的MVVM框架对于激发通知事件的方法命名,如Prism和MVVMLight 框架中使用的是RaisePropertyChanged,Caliburn Micro中使用的是NotifyOfPropertyChange。
如果需要指定激发属性通知事件方法的名称,则如下指定即可。(基本是使用默认配置的,因为默认值已经覆盖大多数的框架。)
<Weavers>
<PropertyChanged EventInvokerNames="NotifyPropertyChanged"/>
Weavers>
用于控制是否启用On_PropertyName_Changed功能。默认值为true,启用该功能。
On_PropertyName_Changed 的功能就是:属性更改时执行对应名称的方法(如Num对应的OnNumChanged)以及OnChangedMethod特性所实现的功能
<Weavers>
<PropertyChanged InjectOnPropertyNameChanged='false'/>
Weavers>
用于控制是否应创建相等检查。如果为false,将对项目禁用相等检查。默认值为true,创建相等检查
<Weavers>
<PropertyChanged CheckForEquality='false'/>
Weavers>
以上就是本文的内容,希望以上内容可以帮助到您,如文中有不对之处,还请批评指正。