在Winform开发框架中下拉列表绑定字典以及使用缓存提升界面显示速度

在咱们开发Winform界面的时候，每每须要绑定数据字典操做，也就是绑定一些下拉列表或者一些列表显示等，以便咱们方便选择数据操做，常见的字典绑定操做就是对下拉列表的处理，本篇随笔是基于DevExpress界面的一些处理操做，原理也适用于常规Winform界面或者DotNetBar控件界面处理。另外对于缓存的处理，通常在基于单机版数据或者局域网API接口处理的字典绑定，速度是比较快的，基本上能够不用考虑缓存的处理，可是对于基于互联网API接口的数据处理，每每受限于带宽等缘由，请求数据的速度没有那么快，那么须要作好数据缓存处理，才可能更好的提升用户体验。

一、常规字典列表的绑定

对于普通的下拉列表控件，咱们绑定操做就是先获取字典数据列表，而后对它的数据项进行添加操做便可，为了方便，咱们每每作成一个扩展函数的方式来进行处理，并把这些通用的扩展函数放到界面基类库里面方便重用，这样咱们能够在设计到界面的数据绑定的时候，很是方便的调用了。

如相似下面的扩展函数定义。

        /// <summary>
        /// 绑定下拉列表控件为指定的数据字典列表
        /// </summary>
        /// <param name="combo">下拉列表控件</param>
        /// <param name="itemList">数据字典列表</param>
        /// <param name="defaultValue">控件默认值</param>
        /// <param name="emptyFlag">是否加入空值选项</param>
        public static void BindDictItems(this ComboBoxEdit combo, List<string> itemList, string defaultValue, bool emptyFlag = true)
        {
            combo.Properties.BeginUpdate();//能够加快
            combo.Properties.Items.Clear();
            combo.Properties.Items.AddRange(itemList);
            if (emptyFlag)
            {
                combo.Properties.Items.Insert(0, "");
            }

            if (itemList.Count > 0)
            {
                combo.SetDropDownValue(defaultValue);
            }

            combo.Properties.EndUpdate();//能够加快
        }

还有有时候咱们须要一个显示文本、值的键值对来对字典进行处理，如定义的CListItem对象

    /// <summary>
    /// 框架用来记录字典键值的类，用于Comobox等控件对象的值传递
    /// </summary>
    [Serializable]
    public class CListItem
    {
        /// <summary>
        /// 显示内容
        /// </summary>
        public string Text { get; set; }

        /// <summary>
        /// 实际值内容
        /// </summary>
        public string Value { get; set; }
    }

这样咱们绑定列表的扩展函数在定义一个函数，以下所示。

        /// <summary>
        /// 绑定下拉列表控件为指定的数据字典列表
        /// </summary>
        /// <param name="combo">下拉列表控件</param>
        /// <param name="itemList">数据字典列表</param>
        /// <param name="defaultValue">控件默认值</param>
        /// <param name="emptyFlag">是否加入空值选项</param>
        public static void BindDictItems(this ComboBoxEdit combo, List<CListItem> itemList, string defaultValue, bool emptyFlag = true)
        {
            combo.Properties.BeginUpdate();//能够加快
            combo.Properties.Items.Clear();
            combo.Properties.Items.AddRange(itemList);
            if (emptyFlag)
            {
                combo.Properties.Items.Insert(0, new CListItem(""));
            }

            if (itemList.Count > 0)
            {
                if (!string.IsNullOrEmpty(defaultValue))
                {
                    combo.SetComboBoxItem(defaultValue);
                }
                else
                {
                    combo.SelectedIndex = 0;
                }
            }

            combo.Properties.EndUpdate();//能够加快
        }

固然，除了上面的这两个处理，咱们还能够定义不少不一样类型的重载方法，以便更方便处理相关的控件的字典数据绑定。

对于固定数据源List<string>、或者List<CListItem>来讲，咱们绑定的操做就很是简单。

List<CListItem> itemList= new List<CListItem>() { new CListItem("有"), new CListItem("无") };
txtItem.BindDictItems(itemList);

而后获取对应字典值的方式，咱们能够定义一个扩展函数来处理，以下代码所示。

        /// <summary>
        /// 获取下拉列表的值
        /// </summary>
        /// <param name="combo">下拉列表</param>
        /// <returns></returns>
        public static string GetComboBoxValue(this ComboBoxEdit combo)
        {
            CListItem item = combo.SelectedItem as CListItem;
            if (item != null)
            {
                return item.Value;
            }
            else
            {
                return "";
            }
        }

对于以上的操做，咱们这里尚未涉及到字典模块里面的数据源，只是提供一些常规的固定列表，咱们知道，大多数的数据字典咱们是经过字典模块来进行维护的。

所以咱们也须要动态的从字典库上获取对应的字典集合来进行绑定。字典的数据，咱们能够经过字典类型或者字典代码来获取，以下是经过字典类型获取对应的字典列表代码。

BLLFactory<DictData>.Instance.GetDictByDictType(dictTypeName);

有了这些数据的获取方法，咱们就能够经过扩展函数来进一步扩展咱们绑定字典类别的方式了，以下扩展函数所示。

        /// <summary>
        /// 绑定下拉列表控件为指定的数据字典列表
        /// </summary>
        /// <param name="combo">下拉列表控件</param>
        /// <param name="dictTypeName">数据字典类型名称</param>
        /// <param name="defaultValue">控件默认值</param>
        public static void BindDictItems(this ComboBoxEdit combo, string dictTypeName, string defaultValue)
        {            
            Dictionary<string, string> dict = BLLFactory<DictData>.Instance.GetDictByDictType(dictTypeName);
            List<CListItem> itemList = new List<CListItem>();
            foreach (string key in dict.Keys)
            {
                itemList.Add(new CListItem(key, dict[key]));
            }

            BindDictItems(combo, itemList, defaultValue);            
        }

使用的时候，就很是简单了，以下代码是实际项目中对字典列表绑定的操做，字典数据在字典模块里面统必定义的。

        /// <summary>
        /// 初始化数据字典
        /// </summary>
        private void InitDictItem()
        {
            txtInDiagnosis.BindDictItems("入院诊断");
            txtLeaveDiagnosis.BindDictItems("最后诊断");

            //初始化代码
            this.txtFollowType.BindDictItems("随访方式");
            this.txtFollowStatus.BindDictItems("随访状态");
        }

这样就很是简化了咱们对字典数据源的绑定操做了，很是方便易读，下面是其中一个功能界面的下拉列表展现。

 

二、使用缓存提升界面响应速度

 前面介绍了经过扩展函数来进一步扩展咱们绑定字典类别的方式了，以下扩展函数所示。

        /// <summary>
        /// 绑定下拉列表控件为指定的数据字典列表
        /// </summary>
        /// <param name="combo">下拉列表控件</param>
        /// <param name="dictTypeName">数据字典类型名称</param>
        /// <param name="defaultValue">控件默认值</param>
        public static void BindDictItems(this ComboBoxEdit combo, string dictTypeName, string defaultValue)
        {            
            Dictionary<string, string> dict = BLLFactory<DictData>.Instance.GetDictByDictType(dictTypeName);
            List<CListItem> itemList = new List<CListItem>();
            foreach (string key in dict.Keys)
            {
                itemList.Add(new CListItem(key, dict[key]));
            }

            BindDictItems(combo, itemList, defaultValue);            
        }
 

若是是基于服务接口的方式（经过Web API或者WCF方式）获取字典列表，那么BLLFactory<T>的方式就修改成CallerFactory<T>的方式获取数据了，以下扩展函数所示。

        /// <summary>
        /// 绑定下拉列表控件为指定的数据字典列表
        /// </summary>
        /// <param name="control">下拉列表控件</param>
        /// <param name="dictTypeName">数据字典类型名称</param>
        /// <param name="defaultValue">控件默认值</param>
        /// <param name="emptyFlag">是否添加空行</param>
        public static void BindDictItems(this ComboBoxEdit control, string dictTypeName, string defaultValue, bool emptyFlag = true)
        {
            Dictionary<string, string> dict = CallerFactory<IDictDataService>.Instance.GetDictByDictType(dictTypeName);
            List<CListItem> itemList = new List<CListItem>();
            foreach (string key in dict.Keys)
            {
                itemList.Add(new CListItem(key, dict[key]));
            }

            control.BindDictItems(itemList, defaultValue, emptyFlag);
        }

也就是经过服务接口工厂方法调用

CallerFactory<IDictDataService>.Instance.GetDictByDictType(dictTypeName);

而获取数据字典列表的内容，这个能够配置为Web API访问方式、WCF访问方式，底层就是调用客户端封装的代理方法获取就是了。例如对于Web API调用来讲就是经过客户端直接访问Web API服务接口获取数据的，实现代码以下所示。

        /// <summary>
        /// 根据字典类型名称获取全部该类型的字典列表集合(Key为名称，Value为值）
        /// </summary>
        /// <param name="dictTypeName">字典类型名称</param>
        /// <returns></returns>
        public Dictionary<string, string> GetDictByDictType(string dictTypeName)
        {
            var action = System.Reflection.MethodBase.GetCurrentMethod().Name;
            string url = GetTokenUrl(action) + string.Format("&dictTypeName={0}", dictTypeName.UrlEncode());

            Dictionary<string, string> result = JsonHelper<Dictionary<string, string>>.ConvertJson(url);
            return result;
        }

因为字典数据是相对比较固定的，通常时效不是那么及时都没问题，因为这部分数据是经过网络的方式获取的，反复的调用获取是会耗费必定的时间。

为了提升用户响应速度，咱们能够把它放到客户端的缓存里面（非服务器缓存），设置必定的失效时间，在失效时间内，咱们数据再也不反复的从网络接口获取，而是直接经过缓存里面提取，速度很是快，同时也提升了界面响应速度。

可是为了避免影响已有代码，咱们能够继续在扩展函数的实现上作一些扩展便可，首先咱们定义一个公共的获取字典数据的方法，以下所示。

        /// <summary>
        /// 获取字典类型的通用处理
        /// </summary>
        /// <param name="dictTypeName">字典类型</param>
        /// <param name="isCache">是否缓存，默认为true</param>
        /// <returns></returns>
        private static Dictionary<string, string> GetDictByDictType(string dictTypeName, bool isCache = true)
        {
            Dictionary<string, string> dict = null;
            if (isCache)
            {
                System.Reflection.MethodBase method = System.Reflection.MethodBase.GetCurrentMethod();
                string key = string.Format("{0}-{1}-{2}", method.DeclaringType.FullName, method.Name, dictTypeName);

                dict = MemoryCacheHelper.GetCacheItem<Dictionary<string, string>>(key,
                    delegate () {
                        return CallerFactory<IDictDataService>.Instance.GetDictByDictType(dictTypeName);
                    },
                    new TimeSpan(0, 30, 0));//30分钟过时
            }
            else
            {
                dict = CallerFactory<IDictDataService>.Instance.GetDictByDictType(dictTypeName);
            }
            return dict;
        }

经过使用 MemoryCacheHelper.GetCacheItem<Dictionary<string, string>> 的方式，咱们能够把它设置为缓存处理方式，若是在失效时间内，则从缓存里面提取。

这样原来的绑定下拉列表的扩展方法获取字典数据，从这个公共的接口里面获取便可，而咱们也仅仅是增长一个具备默认值的缓存与否的参数，用来决定是否使用缓存模式，默认为使用缓存处理。

        /// <summary>
        /// 绑定下拉列表控件为指定的数据字典列表
        /// </summary>
        /// <param name="control">下拉列表控件</param>
        /// <param name="dictTypeName">数据字典类型名称</param>
        /// <param name="defaultValue">控件默认值</param>
        /// <param name="emptyFlag">是否添加空行</param>
        public static void BindDictItems(this ComboBoxEdit control, string dictTypeName, string defaultValue, bool isCache = true, bool emptyFlag = true)
        {
            var dict = GetDictByDictType(dictTypeName, isCache);

            List<CListItem> itemList = new List<CListItem>();
            foreach (string key in dict.Keys)
            {
                itemList.Add(new CListItem(key, dict[key]));
            }

            control.BindDictItems(itemList, defaultValue, emptyFlag);
        }

这样原来的数据下拉列表绑定的方式没有变化，依旧是咱们原来的代码，可是默认采用缓存方式来绑定基于网络接口（混合框架模式）获取的字典数据。

        /// <summary>
        /// 初始化数据字典
        /// </summary>
        private void InitDictItem()
        {
            //初始化代码
            this.txtSurgeryType.BindDictItems("手术方式");
            this.txtIsFirstTime.BindDictItems("首发");
            this.txtWHOGrade.BindDictItems("病理WHO分级");
            this.txtLesionPart.BindDictItems("病灶部位");

            this.txtOccupation.BindDictItems("病人职业");
            this.txtRelapse.BindDictItems("复发");
            this.txtPathologyGrade.BindDictItems("病理分级");
            this.txtSymptom.BindDictItems("初发症状");
            this.txtAnesthesiaMethod.BindDictItems("麻醉方法");
            this.txtSpecimenDetail.BindDictItems("具体标本状况");
        }

获得的编辑界面以下所示，使用缓存接口，对于大量字典数据显示的界面，界面显示速度有了不错的提高。

而对于一些特殊列表的字典显示，如须要经过拼音首字母进行检索功能的下拉列表，咱们依旧可使用这种绑定的方式实现缓存处理的。

如字典绑定的扩展函数以下所示，这样就统一了整个字典列表的绑定操做，比较容易记住。

        /// <summary>
        /// 绑定下拉列表控件为指定的数据字典列表
        /// </summary>
        /// <param name="combo">下拉列表控件</param>
        /// <param name="dictTypeName">数据字典类型名称</param>
        /// <param name="defaultValue">控件默认值</param>
        public static void BindDictItems(this CustomGridLookUpEdit combo, string dictTypeName, string defaultValue, bool isCache = true)
        {
            string displayName = dictTypeName;
            const string valueName = "值内容";
            const string pinyin = "拼音码";
            var dt = DataTableHelper.CreateTable(string.Format("{0},{1},{2}", displayName, valueName, pinyin));

            var dict = GetDictByDictType(dictTypeName, isCache);
            foreach (string key in dict.Keys)
            {
                var row = dt.NewRow();
                row[displayName] = key;
                row[valueName] = dict[key];
                row[pinyin] = Pinyin.GetFirstPY(key);
                dt.Rows.Add(row);
            }

            combo.Properties.ValueMember = valueName;
            combo.Properties.DisplayMember = displayName;
            combo.Properties.DataSource = dt;
            combo.Properties.PopulateViewColumns();
            combo.Properties.View.Columns[valueName].Visible = false;
            combo.Properties.View.Columns[displayName].Width = 400;
            combo.Properties.View.Columns[pinyin].Width = 200;
            combo.Properties.PopupFormMinSize = new System.Drawing.Size(600, 0);

            if (!string.IsNullOrEmpty(defaultValue))
            {
                combo.EditValue = defaultValue;
            }
        }

界面效果以下所示。

以上就是常规单机版数据绑定操做，以及基于网络版缓存数据的数据字典绑定操做，咱们在界面代码的处理上没有任何差别，只是辅助扩展函数作一些调整就能够很好的变化过来了，这样对于咱们界面代码的重用或者调整是很是便利的，同时缓存的使用，对于网络性能有所差别的地方，速度也会明细的有所提升。以上就是对于字典模块的一些处理上的分享，但愿对你们开发Winform界面代码有所帮助和启发。