https://www.cnblogs.com/foreachlife/p/xafviewcontrollerAndValidationContext.html
是的,XAF也是MVC结构的,但不仅限于MVC,ViewModel也存在,它是一项复合技术,AOP,ORM,MVC都有。
真实运行的系统中,仅有增删改查功能肯定是远远不够的,ERP、CRM等系统的开发中,有无数的业务逻辑,通常这些都是在控制器中实现的,控制器有两种:
ViewController:应用于视图,需要操作视图的数据。
WindowsController:应用于窗口,比如当前界面还没有视图,与具体视图也没有关系,比如登出系统按钮,不用考虑当前在哪个视图下面都可以做些操作。
需求:为客户类填加审核操作。
第一步,我们需要为客户类填加一个属性,即,已审核:
找到客户.cs类:
public class 客户.....{............. private bool _已审核; [ModelDefault("AllowEdit","False")] public bool 已审核 { get { return _已审核; } set { SetPropertyValue("已审核", ref _已审核, value); } }.............}
这里,使用了新的Attribute,ModelDefault,它是让已审核这个属性在界面上是只读的,因为我们想用控制器控制些属性的值,所以将其禁止修改,改为按钮控制。
第二步,创建视图控制器:
如下所示,在解决方案中找到XCRMDemo.Module项目,展开,找到Controllers文件夹,右键->添加->新建项.
当然,是不是放到Controllers文件夹都是可以的,也可以自己按业务情况新建文件夹:
然后出现:
在名称处输入CheckViewController.cs
创建完成后,并不上像上图一样,有一个审核按钮,需要从工具箱中拖一个SimpleAction到空白区域。
选中新拖过来的按钮,并按下F4查看属性窗口,这里就与普通的窗体程序一样的界面了。
如图所示,将3处都修改一下。
在属性栏中找到闪电图标,找到Execute并双击。
private void 审核_Execute(object sender, SimpleActionExecuteEventArgs e) { var x = this.View.CurrentObject as 客户; x.已审核 = true; ObjectSpace.CommitChanges(); }
可以看到有一个事件是空白的,敲入上述代码。
按下F5查看效果:
打开一条已有的记录,可以看到,已审核前面的checkbox已经不可以点了,而且在工具栏中已经有了一个”审核”按钮。
按下审核按钮后,界面上的已审核checkbox也会打上勾。
而且,完成后,不要点保存按钮,直接点击左侧导航中的客户信息,来到列表中,可以看到数据已经保存了。
下面我们来看一下写的那三行代码:
var x = this.View.CurrentObject as 客户; //this代表了当前控制器,View是当前控制器所生效的视图,CurrentObject是指当前操作的数据对象。因为当前是在详细视图下面,CurrentObject就是指打开的那条记录了。但是因为这个变量是通用的,所以为Object类型,我们可以转换为客户类。 x.已审核 = true;//转换完成后,就可以对属性值变更了。 ObjectSpace.CommitChanges();//ObjectSpace在控制器中是一个IObjectSpace接口类型,因为XAF会支持EF/XPO所以ObjectSpace的实例是XAF控制的简单的理解ObjectSpace就是对象的总控制对象,比如新建,删除,查询,都是通过它来进行,就像是直接在操作数据库,但是对象比库结构复杂,比如还方含方法、事件等编程元素在里面,所以它看起来比数据库功能强大多了。这里调用了 ObjectSpace.CommitChanges()即为提交变更的内容。当然如果不写这句,界面上也会发生变化,只是没有保存,需要保存时,我们可以再按下保存按钮。 实现自定义上下文: 在验证规则一节中的规则有上下文的概念,即,某些规则只在某个操作执行才被执行,我们上面增加了审核按钮,希望客户信息仅在审核时才为必填:第一步,增加验证规则:
public class 客户.....{................ private DateTime _出生日期; [RuleRequiredField("审核时必填出生日期","审核")] public DateTime 出生日期 { get { return _出生日期; } set { SetPropertyValue("出生日期", ref _出生日期, value); } }................}
可以看到,[RuleRequiredField("审核时必填出生日期","审核")] 中,第一个参数是规则的名称,第二个参数是生效上下文的名称,此时这个上下文是不存的。
下图展示如何创建上下文:
打开xafml文件,展开ActionDesign->Actions->点击审核按钮,在右键属性中找到ValidationContexts,输入“审核“
F5运行项目,新建客户信息,不输入任何内容,直接按下审核按钮:
可以看到出生日期上面的验证规则生效了,而姓名必填规则没有触发。问题:姓名也是需要必填的,怎么能让保存时执行验证,审核时也执行验证呢?很简单,让审核按钮具有两种上下文环境就可以了:
效果:
你也许看到了,审核按钮好象在哪里都有,有客户列表上出现并点击时,还会报错。这是因为这个按钮是有生效位置限制的,我们制作时仅是希望它能在客户的详细视图中显示,但现在却哪里能看到,好,下面我们来处理一下:
打开CheckViewController的设置界面,查看按钮的属性窗口,进行如下设置:
其中,TargetOjectType是指在哪种类型上面生效,TargetViewType是指哪种视图类型,选择为DetailView后,只能在DetailView中看到审核按钮了。 下面再说说这些属性都是做什么的:1.Name,是指生成按钮的代码中的名称。2.ActionMeaning,是指按钮在对话框中生效时,代表的是什么意义,有 Unknown无意义,Accept接受,相当于OK按钮,Cancel,相当于取消按钮。3.Caption,按钮显示的文字4.Category,按钮显示的位置5.ConfirmationMessage,按下按钮时显示一个确认对话框,并显示这段文字,如删除时,显示”确定要删除吗?"6.ID指显示按钮的名称,全局唯一的。7.ImageName,按钮显示什么图标,这里不能选择,可以去xafml中选择那里是有预览图标可以看的。8.PaintStyle,是指绘制的风格,可以选择要不要显示图标,文字,或一起显示。默认是都显示。9.QuickAcces,仅在winform中生效,是指在ribbon方式下显示时,显示在快速访问的位置。10.SelectionDependencyType,有三个选项,Independent:没有限制,RequireSingleObject:选中一个对象时按钮可用,RequireMultipleObject:选中多个对象时按钮可用,含一个。可以看到我们之前的按钮没有这项选择依然可用。而列表上的删除按钮,是RequireMultipleObject,即,可以同时删除多条记录。11.Shortcut:快捷键,仅在win中生效。12.TargetObjectCriteria,这里填写的是一个条件,比如写的是 "!已审核",则只在没有被审核的记录才能点击这个按钮,否则是不可以用的。13.TargetObjectsCriteriaMode:指定是否所有当前选定的对象必须满足targetobjectscriteria条件时才可以执行这个按钮。
可先值:trueatleastforone
在选定的对象中至少有一个必须满足的targetobjectscriteria条件才能执行按钮。
trueforall
所有选定的对象必须都满足的targetobjectscriteria条件才能执行按钮。
这个就需要看业务要求来选择使用了,通常都是trueforall的。
14.TargetObjectType:哪个类型可以显示按钮。如果有多种对象都需要显示,我们演示的是客户这个类,其实继承自客户类的视图也会被生效,继承还没有演示过,后面会展示。
15.TargetViewID:仅指定的视图才会生效。视图ID在哪里?可以打开xafml找到指定的视图,在ID属性栏中就有。比如客户详细视图就是 客户_DetailView.
16.TargetViewNesting:目标视图嵌套,有如下可选项:
名称 | 说明 | |
---|---|---|
Any | 任何视图都会生效. | |
Nested | 必须是嵌套的视图才生效,什么是嵌套的视图?比如客户详细视图中的联系人列表,所属大区列表. | |
Root | 非嵌套的视图,就是root级别了,比如列表视图,详细视图。 |
17.TargetViewType:视图类型
名称 | 说明 | |
---|---|---|
Any | 任何视图. | |
DashboardView | 组合视图,这种还没有出现过,后面介绍. | |
DetailView | 详细视图 | |
ListView | 列表视图 |
18.ToolTip:鼠标悬停时的提示信息。
按钮的属性就这么多,接下来再来看看控制器的属性:
不选中任何按钮,在控制器设计界面的空白区域点击一下,查看属性栏可以看到:
从TargetObjectType开始,才是有意义的。
这里的设置与按钮是一样的,需要注意的是,这里的Targetxxxxx是针对于整个控制器的,一个控制器中可以有多个按钮,比如设置了TargetObjectType后,所有按钮都在满足这个条件后,才会显示在界面上。
QQ 4603528 QQ群:336090194
标签:
XAF, 快速开发, C#, .Net, ViewController, SimpleAction, ValidationContext
原文地址:https://www.cnblogs.com/xyyhcn/p/11719533.html