C/S Winform开发框架 - 单表基础资料窗体实现主从表资料管理


实用小技巧-开发框架文库

C/S Winform开发框架 - 单表基础资料窗体实现主从表资料管理

一、引言

单表窗体是指管理与维护单表基础数据的Winform窗体,通常用于管理与维护客户、产品、货币、单位等基础资料。

我们在实际开发过程中,往往单表窗体也会衍生出主从表结构的数据,本文将介绍基于单表窗体扩展主从表结构。

二、开发过程

本文以《客户资料》管理窗体为例,扩展客户收货地址,作为客户资料的明细表,请参考以下步骤快速开发。

1、表结构,主键,外键关系

dt_Customer:客户表,主键:CustomerCode

dt_Address:地址表,外键:OwnerCode,对应客户表的 CustomerCode

2、绑定明细表的数据源

vs 打开 frm_Customer窗体,在 DoBindingSummaryEditor 方法内获取明细表资料,并绑定表格数据源。

C# 全选
        protected override void DoBindingSummaryEditor(object summary)
        {
            this.DoBindingEditorPanel(pcDetailEditor, summary);
            this.DoBindingEditorPanel(tpDocParams, summary);
            
            //在这里绑定明细表数据源
            var listAddress = _BLL.GetDetails(_BLL.DataBinder.CustomerCode);
            gcAddress.DataSource = listAddress;
        }

 

3、实现BLL、DAL层 GetDetails 方法

C# 全选
/// <summary>
        /// 获取客户收货地址
        /// </summary>
        /// <param name="customerCode"></param>
        /// <returns></returns>
        public List<dt_Address> GetDetails(string customerCode)
        {
            var q = _Database.GetQueryable<dt_Address>();
            return q.Where(w => w.OwnerType == AddressOwnerType.Customer.ToString()
            && w.OwnerCode == customerCode).ToList();
        }

 

4、实现BLL层自定义 Update 方法

因为提交2个表的资料,需要扩展BLL.Update方法,增加一个 listAddress 参数。

C# 全选
        /// <summary>
        /// 扩展 Update 方法,传入地址管理表格的数据源
        /// </summary>
        /// <param name="type">当前操作模式(add/edit)</param>
        /// <param name="listAddress">地址管理表格的数据源</param>
        /// <returns></returns>
        public virtual bool Update(UpdateType type, List<dt_Address> listAddress)
        {
            //更新公共字段的数据
            SetDetailCommonValue(_DataBinder);

            var data = this.CreateSaveData(type, _DataBinder);

            var input = new CustomerUpdateModel
            {
                MasterDataUpdate = data,
                Address = listAddress,
            };

            //调用数据层的方法提交数据
            return _Bridge.Update(input);
        }

 

5、DoSave 方法 调用 _BLL.Update

C# 全选
        /// <summary>
        /// 保存资料,btnSave按钮事件
        /// </summary>
        public override void DoSave(IButtonInfo sender)
        {
            try
            {
                //省略代码...
                var listAddress = gvAddress.GetDataSource<dt_Address>();
                bool result = _BLL.Update(_UpdateType, listAddress);//调用业务逻辑层接口保存数据
                if (result)
                {
                    //省略代码...                
                }             
        }

 

6、扩展 DAL层的Update方法

 

C# 全选
        public bool Update(CustomerUpdateModel input)
        {
            try
            {
                _Database.BeginTransaction();

                //提交主表:客户资料
                base.Update(input.MasterDataUpdate, _Database, false);

                #region 提交明细表:客户地址资料

                SetCommonValue<dt_Address>(input.Address);

                //获取当前客户编码,作为客户地址表的外键值
                var customerCode = input.MasterDataUpdate.VisibleList.First().CustomerCode;
                foreach (var v in input.Address)
                {
                    //新增记录,设置默认值
                    if (v.isid.IsEmpty())
                    {
                        v.isid = IdHelper.GetId();
                        v.OwnerType = PublicEnum.AddressOwnerType.Customer.ToString();
                        v.OwnerCode = customerCode;
                    }
                }

                //删除旧数据
                _Database.Remove<dt_Address>(w => w.OwnerType == PublicEnum.AddressOwnerType.Customer.ToString() && w.OwnerCode == customerCode);

                //保存地址
                _Database.Add(input.Address);

                #endregion

                _Database.CommitTransaction();

                return true;
            }
            catch (System.Exception)
            {
                _Database.RollbackTransaction();
                throw;
            }
        }

 

7、客户资料提交数据模型

C# 全选
 /// <summary>
    /// 客户资料提交数据模型
    /// </summary>
    public class CustomerUpdateModel
    {
        //主表数据
        public MasterDataUpdate<dt_Customer> MasterDataUpdate { get; set; }

        /// <summary>
        /// 明细表数据
        /// </summary>
        public List<dt_Address> Address { get; set; }

        //
        //在这里可以添加多个明细表
        //
    }

 

8、客户地址表格添加【新增】、【删除】按钮

下面代码包括 客户地址表格样式设置、初始化表格的新增、删除按钮。

C# 全选
          frmGridCustomize.RegisterGrid(gvAddress);//注册表格组件,自动添加右键弹出菜单功能
            DevStyle.SetGridControlLayout(gcAddress, true);//明细表表格样式设置
            DevStyle.SetDetailGridViewLayout(gvAddress);//明细表表格样式设置
            gcAddress.EmbeddedNavigator.ButtonClick += new NavigatorButtonClickEventHandler(this.OnEmbeddedNavigatorButtonClick_Process); //绑定明细表格的按钮事件

 

C# 全选
        /// <summary>
        /// 明细表格按钮事件
        /// </summary>
        /// <param name="sender">GridControlNavigator组件</param>
        /// <param name="e">事件参数</param>
        private void OnEmbeddedNavigatorButtonClick_Process(object sender, NavigatorButtonClickEventArgs e)
        {
            try
            {
                GridControl gc = (GridControl)((GridControlNavigator)sender).Parent;
                GridView gv = (GridView)gc.Views[0]; //明细表格:取GridControl第一个GridView组件.

                //新增或插入记录
                if (e.Button.ImageIndex == DetailButtons.Add || e.Button.ImageIndex == DetailButtons.Insert)
                {
                    var row = new dt_Address();
                    row.OwnerCode = txtCustomerCode.Text;
                    row.OwnerType = PublicEnum.AddressOwnerType.Customer.ToString();

                    if (e.Button.ImageIndex == DetailButtons.Add)//增加-Add
                    {
                        gv.AddRow(row);
                    }
                    else if (e.Button.ImageIndex == DetailButtons.Insert)//插入-Insert
                    {
                        gv.InsertRow(row);
                    }
                    gv.FocusedColumn = gv.VisibleColumns[0];//第1列设置焦点单元格

                }
                else if (e.Button == gc.EmbeddedNavigator.Buttons.CustomButtons[DetailButtons.Delete])
                {
                    if (Msg.AskQuestion("确定要删除这条记录?"))
                        gv.DeleteRow(gv.FocusedRowHandle);
                }
                e.Handled = true;
            }
            catch (Exception ex)
            {
                LogUserOperate.Write(ex);
                Msg.ShowException(ex);
            }
        }

9、ButtonStateChanged 事件处理控件状态

C# 全选
  protected override void ButtonStateChanged(UpdateType currentState)
        {
            base.ButtonStateChanged(currentState);

            this.SetDetailEditorsAccessable(tpDocParams, this.DataChanged);
            this.SetDetailEditorsAccessable(tpAddress, this.DataChanged);
            gvAddress.OptionsBehavior.Editable = this.DataChanged;
        }

 

三、数据编辑页拆分为多个标签页面

拆分目的:当资料列数量较多,或者需要按类型区分管理

操作步骤:

步骤1:添加标签页

选择 tcBusiness 组件,点右侧小三角图标,点击 Add Tab Page 菜单添加标签页。

      C/S Winform开发框架 - 单表基础资料窗体实现主从表资料管理

步骤2:重写 ShowSummaryPage / ShowDetailPage 方法

 

C# 全选
  protected override void ShowSummaryPage(bool disableDetailPage)
        {
            base.ShowSummaryPage(disableDetailPage);

            if (disableDetailPage)
            {
                tpDocParams.PageEnabled = false;
                tpAddress.PageEnabled = false;
            }
        }

 

C# 全选
        protected override void ShowDetailPage(bool disableSummaryPage)
        {
            this.tpDetail.PageEnabled = true;
            tpSummary.PageEnabled = !disableSummaryPage;
            tpDocParams.PageEnabled = true;
            tpAddress.PageEnabled = true;

            if (tcBusiness.SelectedTabPage == tpSummary)
                tcBusiness.SelectedTabPage = this.tpDetail;
        }

 

步骤3:修改 DoBindingSummaryEditor 方法,绑定数据源

C# 全选
 protected override void DoBindingSummaryEditor(object summary)
        {
            this.DoBindingEditorPanel(pcDetailEditor, summary);
            this.DoBindingEditorPanel(tpDocParams, summary); //绑定拆分标签页的数据源

            //省略代码...
    
        }

 

步骤4:状态控制 ButtonStateChanged

 

C# 全选
 protected override void ButtonStateChanged(UpdateType currentState)
 {
            base.ButtonStateChanged(currentState);

            //扩展的标签页组件状态控制
            this.SetDetailEditorsAccessable(tpDocParams, this.DataChanged);
            this.SetDetailEditorsAccessable(tpAddress, this.DataChanged);          
            gvAddress.OptionsBehavior.Editable = this.DataChanged;

           //省略代码....
}

 

四、效果图

C/S Winform开发框架 - 单表基础资料窗体实现主从表资料管理

 

版权声明:本文为开发框架文库发布内容,转载请附上原文出处连接
C/S框架网
上一篇:CSFramework开发框架 - 开发界面窗体注意事项、测试项
下一篇:CSFrameworkV6 - 支持单表基础资料表格批量编辑数据(IGridDataWatcher接口DevExpressGridViewWatcher使用)
评论列表

发表评论

评论内容
昵称:
关联文章

C/S Winform开发框架 - 基础资料实现主从资料管理
新增基础资料 - MiniFramework蝇量框架 - Winform框架
C/S系统快速开发框架数据操作主从)按钮事件
CSFrameworkV6旗舰版 - 基础资料完整C#源码
Winform查询数据对话与选择资料实现|C/S框架
开发基础资料报表() - MiniFramework蝇量框架 - Winform框架
新增业务单据主从 - MiniFramework蝇量框架 - Winform框架
C/S开发框架教程:使用基础资料(数据字典)的DAL层更新主从(或多)数据
一.数据字典-基础资料-C/S快速开发框架-标准版V2.3
三.数据字典实现及逻辑关系图-基础资料-C/S快速开发框架-标准版V2.3
CSFrameworkV6-主从基础资料扩展【复制】按钮
WinFramework轻量级开发框架 - 主从开发指南-详细二次开发
四.数据字典开发步骤-基础资料-C/S快速开发框架-标准版V2.3
CSFrameworkV6 - 支持基础资料表格批量编辑数据(IGridDataWatcher接口DevExpressGridViewWatcher使用)
新增主从业务单据 | C/S架构软件开发平台 - 旗舰版V6.0
公共基础资料管理 - 实例源码 - C/S快速开发框架旗舰版V5
WinFramework轻量级开发框架 - 数据开发 - 界面二次开发
WinFramework轻量级开发框架 - 主从开发指南-采购订单
什么是数据字典? 什么是基础数据? 什么是数据字典
代码生成器 CodeGenerator - 生成业务 (主从数据管理界面)

热门标签
.NET5 .NET6 .NET7 APP Auth-软件授权注册系统 Axios B/S B/S开发框架 Bug Bug记录 C#加密解密 C#源码 C/S CHATGPT CMS系统 CodeGenerator CSFramework.DB CSFramework.EF CSFrameworkV1学习版 CSFrameworkV2标准版 CSFrameworkV3高级版 CSFrameworkV4企业版 CSFrameworkV5旗舰版 CSFrameworkV6.0 DAL数据访问层 Database datalock DbFramework Demo教学 Demo下载 DevExpress教程 DOM EF框架 Element-UI EntityFramework ERP ES6 Excel FastReport GIT HR IDatabase IIS JavaScript LINQ MES MiniFramework MIS NavBarControl Node.JS NPM OMS ORM PaaS POS Promise API Redis SAP SEO SQL SQLConnector TMS系统 Token令牌 VS2022 VSCode VUE WCF WebApi WebApi NETCore WebApi框架 WEB开发框架 Windows服务 Winform 开发框架 Winform 开发平台 WinFramework Workflow工作流 Workflow流程引擎 版本区别 报表 踩坑日记 操作手册 代码生成器 迭代开发记录 基础资料窗体 架构设计 角色权限 开发sce 开发技巧 开发教程 开发框架 开发平台 开发指南 客户案例 快速搭站系统 快速开发平台 秘钥 密钥 权限设计 软件报价 软件测试报告 软件简介 软件开发框架 软件开发平台 软件开发文档 软件体系架构 软件下载 软著证书 三层架构 设计模式 生成代码 实用小技巧 收钱音箱 数据锁 数据同步 微信小程序 未解决问题 文档下载 喜鹊ERP 喜鹊软件 系统对接 详细设计说明书 行政区域数据库 需求分析 疑难杂症 蝇量级框架 蝇量框架 用户管理 用户开发手册 用户控件 在线支付 纸箱ERP 智能语音收款机 自定义窗体 自定义组件 自动升级程序