XAF 属性编辑器（PropertyEditor）- 原理篇

前言

随着 DEV24.1.3 的发布，XAF Blazor 中的属性编辑器（PropertyEditor）也举行了很大的改动，在使用体验上也更接近 WinForm 了，由于举行了大量的封装，理解上没有 WinForm 直观，所以本文通过对属性编辑器的原理举行剖析，并对比新旧版本中的变化，使各人能够对属性编辑器有一个更全面的熟悉。
原理

XAF 可以创建与平台无关的业务代码，而 PropertyEditor 就是它们与各个平台之间的一个桥梁，也就是说 PropertyEditor 每个平台都有各自的实现。从外貌上看 PropertyEditor 的原理并不复杂，BO 中属性的更改会触发 PropertyEditor 中值的更改，而 PropertyEditor 值的更改又会更新具体平台组件的值，反过来也是一样，组件值的更改会触发 PropertyEditor 值的更改，而PropertyEditor 值的更改又会更新 BO 中的属性值。

如果我们使用的是XPO，PersistentBase 是全部 BO 的基类，它实施一个 INotifyPropertyChanged 接口，我们可以通过 INotifyPropertyChanged 接口来监听每一个属性的变化，这样我们就可以在属性值发生变化时关照 PropertyEditor，而这个监听工作是在 DetailView 中完成的。DetailView 在监听到 BO 中属性值发生更改时，会查找到具体的 PropertyEditor，并调用它的 Refresh 方法。

PropertyEditor 的属性（如：Caption，DisplayFormat）大部分来自 XAF 的 Model，也就是在 PropertyEditor 初始化时会传递一个 IModelMemberViewItem 对象，它里面包含了我们在模子编辑器中设置的值或一些默认值。

PropertyEditor 中有两个比较重要的方法 ReadValue 与 WriteValue，我一开始看到这个两方法时也产生了混淆，ReadValue 与 WriteValue 它们针对的对象是 BO 中的属性，而不是 PropertyEditor，也就是说 ReadValue 是读取 BO 中属性的值，而 WriteValue 是将值写入到属性中。
PropertyEditor 中另有一个 Control 属性，它的类型是 Object，差别的平台它返回的类型是不一样的，这个也是各个平台的组件，WinForm 返回的是 Control 类型，Blazor 返回的是 ComponentAdapter 或 ComponentModel (24.1.3之后 XAF 自带编辑器默认返回类型)。由于差别的平台渲染方式差别，对于 WinForm 来说，它返回的是 Control 类型，可以直接将其放置到父组件的 Controls 中，而对于 Blazor 就不行，Blazor 组件就不能像 WinForm 控件那样操作，它是通过 RenderFragment 举行组合在一起的，所以 Blazor 中的 PropertyEditor 同时还实施了一个 IComponentContentHolder 接口，通过它可以返回一个 RenderFragment。

在对外袒露组件时，Blazor 比 WinForm 要多一步，Blazor 中的 RenderFragment 是用于渲染组件的，不能通过 Control 属性返回，同时我们也无法直接操作 RenderFragment，我们是通过 ComponentModel 间接操作 Blazor 组件渲染的，所以当我们在外部想自定义 PropertyEditor 中的组件时，WinForm 是直接操作 Control，而 Blazor 是通过 ComponentModel 来完成。

PropertyEditor 的大部分子类都是围绕上面提到的属性或方法举行封装，以顺应差别的平台。对于 WinForm 来说相对比较简单，就是直接操作 Control，而对于 Blazor 来说就要繁琐一些，就因为这样 XAF 针对 Blazor PropertyEditor 创建，做了大量的封装，特别是在最新的24.1.3中丢弃了 ComponentAdapter，使 PropertyEditor 的创建更加简单，甚至比 WinForm 还要简洁一些。下面重要以 Blazor 为主介绍 PropertyEditor 的相关技术点。

由于本文讲的是 PropertyEditor 的原理，默认读者是熟悉 PropertyEditor 的创建，所以不会再去讲解 PropertyEditor 的创建过程，而是只讲解它的技术点，如果对 PropertyEditor 的创建不熟悉的小同伴，可以查看 XAF 的官方文档。

在 XAF 新版本中 ComponentAdapter 被废弃了，那它被引入的缘故原由及被废弃的缘故原由是什么呢？在 XAF Blazor 创建之初 ComponentAdapter 就已存在，通过它的名字我们知道它是一个代理层，负责 PropertyEditor 与 ComponentModel 之间的通讯。那为什么要加入这个代理层呢，而不是 PropertyEditor 直接操作 ComponentModel 呢。这里重要思量是 PropertyEditor 的封装，由于 PropertyEditor 的操作基本是固定的（如，读值、写值及一些常规属性的设置），而 ComponentModel 是针对差别的组件的，差别的组件会有差别的属性，好比雷同值属性，文本框是Text，日期框是Date，数值框是Value等，通过 ComponentAdapter 来适配差别的 ComponentModel（如：GetValue，SetValue 等），PropertyEditor 再去操作 ComponentAdapter ，这样更利于 PropertyEditor 的封装。
那在新版本中为什么 ComponentAdapter 又被废弃了呢，通过 XAF 的博客可以了解到，由于增加了 ComponentAdapter，使创建自定义 PropertyEditor 变的比较繁琐，移除 ComponentAdapter 后，可以使 PropertyEditor 的创建更接近于 WinForm。在没有了 ComponentAdapter 后，是不是 PropertyEditor 直接操作 ComponentModel 了呢，如果是那样的话，就会出现前面所讲到的，这会增加自定义 PropertyEditor 的复杂度，那新版是怎样实现的呢。新版中是通过接口的方式来替代 ComponentAdapter，如新版中增加了一个 IHandleValueComponentModel 接口，通过这个接口 PropertyEditor 就可以获取、更新或监听组件值的变化，同时又增加了 DxComponentModelBase 这样的一个基类，它包含了一些常用的属性。也就是说新版是通过增加差别的接口及扩展基类的方式来替代 ComponentAdapter，这样在简化自定义 PropertyEditor 的同时，也保持了 PropertyEditor 的机动性。
ComponentModel 在新版中还增加了一个 ComponentType 属性，XAF 通过 ComponentType 属性，可以自动完成 Renderer 的创建及属性的赋值。在之前的版本中我们都是在 Renderer 中创建一个 Create 静态方法，将 ComponentModel 传递进去，Renderer 需要将 ComponentModel 中的属性一一赋值给组件，这个过程非常繁琐，特别是 XAF 自身的 Renderer，代码量非常的大。新版中通过 ComponentType 的组件类型实现组件自动创建的同时，还将 ComponentModel 的属性自动传递给组件（提示：ComponentModel 的属性要与组件的属性保持同等）。由于 XAF 中的 PropertyEditor 都是对 Blazor 组件的封装，在 XAF 中直接省掉了 Renderer，也就是在 XAF 中没有 Renderer 的相关代码了。
在新版中创建一个 Blazor PropertyEditor 则相当简单，起首创建一个继续自 DxComponentModelBase 的 ComponentModel，在 ComponentModel 中增加组件所需要的属性，如果是自定义组件需要创建一个 Renderer，如果是 DEV 自身的 Blazor 组件，则直接将组件赋值给 ComponentType，同时基于 BlazorPropertyEditorBase 再创建一个 PropertyEditor，重写 CreateComponentModel 方法，并返回 ComponentModel 实例，整个 PropertyEditor 创建过程就结束了，相对来说要比 WinForm 还要简洁一些。
总结

在日常的 XAF 开发中，不管是增强或是个性化定制，都离不开 PropertyEditor，简化 PropertyEditor 的创建过程，在降低创建 PropertyEditor 难度的同时，也能大幅进步自定义 PropertyEditor 在项目中的占比，进步用户操作体验。
https://www.cnblogs.com/haoxj/p/18255657

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。