XAF Excel数据导入模块使用说明与源码

 

我实现了XAF项目中Excel数据的导入,使用Devexpress 新出的spreadsheet控件,可能也不新了吧:D

好,先看一下效果图:下图是Web版本的。

下面是win版:

 

功能说明:

支持从Excel任意版本导入数据,可以使用 打开文件功能选择现有的文件,没有模板时,请来到上图界面中,另存为Excel到本地,往模板上填加数据。

导入时使用了显示名称进行匹配字段,所以字段部分不要修改。

导入时会使用你在写好的验证规则。

支持Win+Web两个版本。

使用方法:

 

第一步:将Admiral.ImportData模块拖到你的项目的模块中去,上图为例,我将把Admiral.ImportData拖到图中A项目中,即MFBI.Module中去。

第二步:将Admiral.ImportData.Web 拖到B中。

第三步:将Admiral.ImportData.Win拖到C中。

你不知道模块在哪里?请看下图:

先打开solution 中的Module.cs, 然后从toolbox拖动ImportDataModule到Required Modules中。

当然这是把源码直接放到项目中去的方法,如果想直接使用DLL,可以编译好后,在toolbox中填加选择项,选择路径后,再进行拖动。

 

再来看看代码中的设置:

以下代码中有两处标红的,第一必须实现IImportData接口才可能导入,这个接口是空的,不用实现。DomainComponent也可以这样使用。

对于普通的字段,没有其他设置。

对于引用型字段,需要[ImportDefaultFilterCriteria("编码=?")]这样,来设置将来查找引用类型的值时,用什么条件进行查找,当然问号会被替换为Excel中真实的值。

    [XafDisplayName("销量明细")]
    [NavigationItem("销售模块")]
    public class 销量明细 : BaseObject,IImportData
    {
        public 销量明细(Session s) : base(s)
        {

        }

        private 订单 _订单;
        [Association]

[ImportDefaultFilterCriteria("编码=?")]
public 订单 订单 { get { return _订单; } set { SetPropertyValue("订单", ref _订单, value); } } ...... }

 

当前模块还比较简单 ,以后会慢慢完善。

 

 20160128已经更新了支持win下面除了ribbon以外其他的界面类型。

 

2016-3-17 将源码发布到github.

地址:https://github.com/tylike/Admiral.ImportData

修复了几个小BUG。

增加了更新导入功能,在业务对象上面写[UpdateImport("属性名称")],其中属性名称是指,在导入时,使用哪个属性的值 Excel->库中的 进行比较,来确定此对象是否存在。

增加了[ImportOptions(false)]属性,可以写在属性或字段上面,设置为false时,即在导入时不显示此字段。

增加给Winform增加了图标。

导入完成后,在Excel中给出了提示信息,成功或不成功。

在查找引用属性时,如果没有使用ImportDefaultFilterCriteria属性进行设置,则按如下优先级进行:

1.看主键是否是非自动生成的,是,则使用主键查找。

2.看引用类上面是否有[RuleUniqueValue]标记的属性,有则使用。

3.看DefaultProperty是否有设置,有则使用。

2016-7-5日更新说明:

增加了FindObjectProviderAttribute,用于提升性能.

需要加速的类上面写这个Attribute即可.

 2016-7-14日更新说明:

Excel导入模块增加了DC的支持,WEB下面可用。增加了Nullable类型的支持,并补全了数字类型的支持。

为了支持web下面新风格皮肤,增加了两个变量:

这两个变量可以在global.asax中进行设置:

1.ASPxSpreadsheetPropertyEditor.IsNewStyle = true; //如果使用了新风格时,需要设置此变量.

2.ASPxSpreadsheetPropertyEditor.SkinName="Aqua"; //由于Spreadsheet控件没有支持新风格,所以这里可以可以手工指定另一个风格,否则显示界面混乱

 

 

转载请注明出处。多谢!

 

posted @ 2016-01-22 14:52  code first life  阅读(3508)  评论(2编辑  收藏  举报