星星评分控件----------WebForm服务器控件开发系列

该控件是继承于 WebControl 基类开发的。目前初步成型，现在的版本只能给大家作为一个基础自定义控件开发的参考，不建议你直接使用，因为还没有进行内存泄漏测试和大量的其他测试。这是个服务器控件不同于客户端的 js控件 和可 WinForm 控件，因为这些客户端控件只是在客户端本地使用，就算是出现内存泄漏，一般重启客户端程序就可以了。但Web服务器控件是运行在服务器上的，而且是大量用户并发使用的，就算有一个小小的内存泄漏，在大量客户端请求下会造成很严重后果。

之所以把它做成Web服务器全局刷新控件，因为JQuery 插件网络上已经很多了而且很完善。而且原生的Web服务器控件很少功能很简单。那有些人问为什么不做成Ajax异步刷新的服务器控件。因为我反编译过 DevExpress Web控件库（全局刷新服务器控件库）和 EXT.NET  Web控件库（Ajax异步刷新服务器控件库） 粗略的看了下他们的开发逻辑，做成Ajax异步这种会更更复杂。所以目前选定全局刷新这种。

开发服务器控件主要是有 ViewState管理  、 复杂属性 、 JS脚本管理 、 TypeConverter数据类型转换器 这些知识。 

该控件使用了图标字体，因为现在Web开发图标字体比较常见，也是一种比较好的选择。为了能在在 VS 的页面设计器能能浏览到图标字体效果，这里对控件做了些特殊处理，系统必须安装项目里面的 wcle_ico.tff 字体。因为 VS 的页面设计器无法直接预览到css加载的图标字体，这时候控件改用1系统安装自定义图标字体输出来模拟。

    /// <summary>
    /// 图标工具类
    /// </summary>
    [Description("图标工具类")]
    public static class IcoUtility
    {
        #region

        /// <summary>
        /// 图标字体文件名称
        /// </summary>
        [Description("图标字体文件名称")]
        public const string IcoFontFileName = "wcle_ico";

        private static object icolist_obj = new object();
        private static IcoFontItemCollection allIco;
        /// <summary>
        /// 所有图标字体信息
        /// </summary>
        [Description("所有图标字体信息")]
        public static IcoFontItemCollection AllIco
        {
            get
            {
                if (IcoUtility.allIco == null)
                {
                    lock (IcoUtility.icolist_obj)
                    {
                        IcoUtility.allIco = new IcoFontItemCollection();

                        Type t = typeof(Ico);
                        FieldInfo[] fieldArr = t.GetFields();
                        for (int i = 0; i < fieldArr.Length; i++)
                        {
                            IcoUnicodeAttribute[] ico_attr = (IcoUnicodeAttribute[])fieldArr[i].GetCustomAttributes(typeof(IcoUnicodeAttribute), false);
                            if (ico_attr != null && ico_attr.Length > 0)
                            {
                                IcoUnicodeAttribute unicode = ico_attr[0];
                                IcoFontItem icoFontInfo = new IcoFontItem() { Name = unicode.Name, Unicode = unicode.Unicode, WinUnicode = unicode.WinUnicode, WebUnicode = unicode.WebUnicode };
                                IcoUtility.allIco.Add(icoFontInfo);
                            }
                        }
                    }
                }

                return allIco;
            }
        }

        #endregion

        #region 公开方法

        /// <summary>
        /// 根据图标名称获取图标Unicode编码(Web用 &#x开头)
        /// </summary>
        /// <param name="Ico"></param>
        /// <returns></returns>
        public static string GetWebUnicode(Ico Ico)
        {
            return IcoUtility.GetWebUnicode(Ico.ToString());
        }

        /// <summary>
        /// 根据图标名称获取图标Unicode编码(Web用 &#x开头)
        /// </summary>
        /// <param name="Name"></param>
        /// <returns></returns>
        public static string GetWebUnicode(string Name)
        {
            Name = Name.Trim();
            foreach (IcoFontItem ico in IcoUtility.AllIco)
            {
                if (ico.Name == Name)
                {
                    return ico.WebUnicode;
                }
            }
            return "";
        }

        /// <summary>
        /// 根据图标名称获取图标Unicode编码(Win用)
        /// </summary>
        /// <param name="Ico"></param>
        /// <returns></returns>
        public static string GetWinUnicode(Ico Ico)
        {
            return IcoUtility.GetWinUnicode(Ico.ToString());
        }

        /// <summary>
        /// 根据图标名称获取图标Unicode编码(Win用)
        /// </summary>
        /// <param name="Name"></param>
        /// <returns></returns>
        public static string GetWinUnicode(string Name)
        {
            Name = Name.Trim();
            foreach (IcoFontItem ico in IcoUtility.AllIco)
            {
                if (ico.Name == Name)
                {
                    return ico.WinUnicode;
                }
            }
            return "";
        }

        /// <summary>
        /// 获取图标字符编码信息
        /// </summary>
        /// <param name="WinUnicode">图标</param>
        /// <returns></returns>
        public static IcoFontItem GetIcoFontItem(Ico Ico)
        {
            foreach (IcoFontItem item in IcoUtility.AllIco)
            {
                if (item.Ico == Ico)
                {
                    return item;
                }
            }
            return null;
        }

        /// <summary>
        /// 获取图标字符编码信息
        /// </summary>
        /// <param name="WinUnicode">图标名称</param>
        /// <returns></returns>
        public static IcoFontItem GetIcoFontItemByName(string Name)
        {
            Name = Name.Trim();
            foreach (IcoFontItem item in IcoUtility.AllIco)
            {
                if (item.Name == Name)
                {
                    return item;
                }
            }
            return null;
        }

        /// <summary>
        /// 获取图标字符编码信息
        /// </summary>
        /// <param name="WinUnicode">u 开头四位图标Unicode编码</param>
        /// <returns></returns>
        public static IcoFontItem GetIcoFontItemByWinUnicode(string WinUnicode)
        {
            WinUnicode = WinUnicode.Trim();
            foreach (IcoFontItem item in IcoUtility.AllIco)
            {
                if (item.WinUnicode == WinUnicode)
                {
                    return item;
                }
            }
            return null;
        }

        /// <summary>
        /// 获取图标字符编码信息
        /// </summary>
        /// <param name="WinUnicode"> &#x 开头四位图标Unicode编码</param>
        /// <returns></returns>
        public static IcoFontItem GetIcoFontItemByWebUnicode(string WebUnicode)
        {
            WebUnicode = WebUnicode.Trim();
            foreach (IcoFontItem item in IcoUtility.AllIco)
            {
                if (item.WebUnicode == WebUnicode)
                {
                    return item;
                }
            }
            return null;
        }

        #endregion
    }

    /// <summary>
    /// 图标 通过https://icomoon.io 网站生产
    /// </summary>
    [Description("图标")]
    public enum Ico
    {
        /// <summary>
        /// 星星
        /// </summary>
        [Description("星星")]
        [IcoUnicodeAttribute("wcle_ico_ratingstars", "1111", "u1111", "&#x1111")]
        wcle_ico_ratingstars,
        /// <summary>
        /// 交叉
        /// </summary>
        [Description("交叉")]
        [IcoUnicodeAttribute("wcle_ico_ratingclear", "1112", "u1112", "&#x1112")]
        wcle_ico_ratingclear,
        /// <summary>
        /// 等级
        /// </summary>
        [Description("等级")]
        [IcoUnicodeAttribute("wcle_ico_level", "1113", "u1113", "&#x1113")]
        wcle_ico_level,

        /// <summary>
        /// 书签
        /// </summary>
        [Description("书签")]
        [IcoUnicodeAttribute("wcle_ico_bookmark", "1114", "u1114", "&#x1114")]
        wcle_ico_bookmark,
        /// <summary>
        /// 黄冠
        /// </summary>
        [Description("黄冠")]
        [IcoUnicodeAttribute("wcle_ico_crown", "1115", "u1115", "&#x1115")]
        wcle_ico_crown,
        /// <summary>
        /// 书签2
        /// </summary>
        [Description("书签2")]
        [IcoUnicodeAttribute("wcle_ico_bookmark2", "1116", "u1116", "&#x1116")]
        wcle_ico_bookmark2,
        /// <summary>
        /// 心型
        /// </summary>
        [Description("心型")]
        [IcoUnicodeAttribute("wcle_ico_heart", "1117", "u1117", "&#x1117")]
        wcle_ico_heart,
        /// <summary>
        /// 钻石
        /// </summary>
        [Description("钻石")]
        [IcoUnicodeAttribute("wcle_ico_diamond", "1118", "u1118", "&#x1118")]
        wcle_ico_diamond,
        /// <summary>
        /// 月亮
        /// </summary>
        [Description("月亮")]
        [IcoUnicodeAttribute("wcle_ico_moon", "1119", "u1119", "&#x1119")]
        wcle_ico_moon
    }

    /// <summary>
    ///图标字符编码信息集合
    /// </summary>
    [Description("图标字符编码信息集合")]
    public sealed class IcoFontItemCollection : IList, ICollection, IEnumerable
    {
        private ArrayList icoFontItemList = new ArrayList();

        public IcoFontItemCollection()
        {

        }

        #region IEnumerable

        public IEnumerator GetEnumerator()
        {
            IcoFontItem[] listArray = new IcoFontItem[this.icoFontItemList.Count];
            for (int index = 0; index < listArray.Length; ++index)
            {
                listArray[index] = (IcoFontItem)this.icoFontItemList[index];
            }
            return listArray.GetEnumerator();
        }

        #endregion

        #region ICollection

        public void CopyTo(Array array, int index)
        {
            for (int i = 0; i < this.Count; i++)
            {
                array.SetValue(this.icoFontItemList[i], i + index);
            }
        }

        public int Count
        {
            get
            {
                return this.icoFontItemList.Count;
            }
        }

        public bool IsSynchronized
        {
            get
            {
                return false;
            }
        }

        public object SyncRoot
        {
            get
            {
                return (object)this;
            }
        }

        #endregion

        #region IList

        public int Add(object value)
        {
            if (!(value is IcoFontItem))
            {
                throw new ArgumentException("IcoFontItem");
            }
            return this.Add((IcoFontItem)value);
        }

        public int Add(IcoFontItem item)
        {
            if (item == null)
            {
                throw new ArgumentNullException("item");
            }
            this.icoFontItemList.Add(item);
            return this.Count - 1;
        }

        public void Clear()
        {
            this.icoFontItemList.Clear();
        }

        public bool Contains(object value)
        {
            if (value == null)
                throw new ArgumentNullException("value");
            return this.IndexOf(value) != -1;
        }

        bool IList.Contains(object item)
        {
            if (item is IcoFontItem)
            {
                return this.Contains((IcoFontItem)item);
            }
            return false;
        }

        public int IndexOf(object item)
        {
            if (item is IcoFontItem)
            {
                return this.icoFontItemList.IndexOf(item);
            }
            return -1;
        }

        public void Insert(int index, object value)
        {
            throw new NotImplementedException();
        }

        public bool IsFixedSize
        {
            get { return false; }
        }

        public bool IsReadOnly
        {
            get { return false; }
        }

        public void Remove(object value)
        {
            throw new NotImplementedException();
        }

        public void Remove(IcoFontItem item)
        {
            throw new NotImplementedException();
        }

        public void RemoveAt(int index)
        {
            throw new NotImplementedException();
        }

        /// <summary>
        /// 
        /// </summary>
        /// <param name="Ico">图标</param>
        /// <returns></returns>
        public IcoFontItem this[Ico Ico]
        {
            get
            {
                foreach (IcoFontItem item in this.icoFontItemList)
                {
                    if (item.Ico == Ico)
                        return item;
                }
                return null;
            }
        }

        /// <summary>
        /// 
        /// </summary>
        /// <param name="Name">图标名称</param>
        /// <returns></returns>
        public IcoFontItem this[string Name]
        {
            get
            {
                foreach (IcoFontItem item in this.icoFontItemList)
                {
                    if (item.Name == Name)
                        return item;
                }
                return null;
            }
        }

        /// <summary>
        /// 
        /// </summary>
        /// <param name="index">索引</param>
        /// <returns></returns>
        public IcoFontItem this[int index]
        {
            get
            {
                return (IcoFontItem)this.icoFontItemList[index];
            }
            set
            {
                this.icoFontItemList[index] = (IcoFontItem)value;
            }
        }

        object IList.this[int index]
        {
            get
            {
                return (object)this.icoFontItemList[index];
            }
            set
            {
                this.icoFontItemList[index] = (IcoFontItem)value;
            }
        }

        #endregion
    }

    /// <summary>
    /// 图标字符编码信息
    /// </summary>
    [Description("图标字符编码信息")]
    public class IcoFontItem
    {
        /// <summary>
        /// 图标
        /// </summary>
        public Ico Ico { get; set; }
        /// <summary>
        /// 图标名称
        /// </summary>
        public string Name { get; set; }
        /// <summary>
        /// 四位图标Unicode编码
        /// </summary>
        public string Unicode { get; set; }
        /// <summary>
        /// u 开头四位图标Unicode编码(Win用)
        /// </summary>
        public string WinUnicode { get; set; }
        /// <summary>
        /// &#x 开头四位图标Unicode编码(Web用)
        /// </summary>
        public string WebUnicode { get; set; }
    }

    /// <summary>
    /// 图标字体对应的四位Unicode编码
    /// </summary>
    [Description("图标字体对应的四位Unicode编码")]
    [AttributeUsage(AttributeTargets.Field, AllowMultiple = false)]
    public class IcoUnicodeAttribute : Attribute
    {
        /// <summary>
        /// 图标名称
        /// </summary>
        public string Name { get; set; }

        /// <summary>
        /// 四位图标Unicode编码
        /// </summary>
        public string Unicode { get; set; }

        /// <summary>
        /// u 开头四位图标Unicode编码(Win用)
        /// </summary>
        public string WinUnicode { get; set; }

        /// <summary>
        /// &#x 开头四位图标Unicode编码(Web用)
        /// </summary>
        public string WebUnicode { get; set; }

        public IcoUnicodeAttribute(string Name, string Unicode, string WinUnicode, string WebUnicode)
        {
            this.Name = Name;
            this.Unicode = Unicode;
            this.WinUnicode = WinUnicode;
            this.WebUnicode = WebUnicode;
        }

    }

wclej = {
    ChangeGradeValue: function (owner, id, callback) {
        /// <summary>更改等级</summary>
        /// <param name="obj" type="string">当前点击节点</param>
        /// <param name="id" type="string">服务器控件uniqueid</param>
        /// <param name="callback" type="bool">是否回发</param>

        var gradevalue = document.getElementById(id + '_value');
        var currentvalue = owner.getAttribute('grade');
        if (gradevalue == undefined || currentvalue == undefined)
            return;

        gradevalue.value = currentvalue;

        if (callback) {
            setTimeout("__doPostBack('" + id + "','')", 0);
        }
        else {
            var ui = document.getElementById(id + '_ui');
            var sumgradecolor = ui.getAttribute('sumgradecolor');
            var currentgradecolor = ui.getAttribute('currentgradecolor');

            var gradeArr = new Array();
            var index = -1;
            for (var i = 0; i < ui.rows[0].cells.length; i++) {
                var itemtype = ui.rows[0].cells[i].getAttribute('itemtype');
                if (itemtype != undefined && itemtype == 'grade') {
                    index++;
                    gradeArr[index] = ui.rows[0].cells[i].children[0];
                }
            }

            for (var i = 0; i < gradeArr.length; i++) {
                gradeArr[i].style.color = (i < currentvalue ? currentgradecolor : sumgradecolor)
            }
        }
    },
    SetGradeValue: function (currentvalue, id, callback) {
        /// <summary>设置等级</summary>
        /// <param name="currentvalue" type="int">要设置的等级</param>
        /// <param name="id" type="string">服务器控件uniqueid</param>
        /// <param name="callback" type="bool">是否回发</param>

        var gradevalue = document.getElementById(id + '_value');
        if (gradevalue == undefined || currentvalue == undefined)
            return;

        gradevalue.value = currentvalue;

        if (callback) {
            setTimeout("__doPostBack('" + id + "','')", 0);
        }
        else {
            var ui = document.getElementById(id + '_ui');
            var sumgradecolor = ui.getAttribute('sumgradecolor');
            var currentgradecolor = ui.getAttribute('currentgradecolor');

            var gradeArr = new Array();
            var index = -1;
            for (var i = 0; i < ui.rows[0].cells.length; i++) {
                var itemtype = ui.rows[0].cells[i].getAttribute('itemtype');
                if (itemtype != undefined && itemtype == 'grade') {
                    index++;
                    gradeArr[index] = ui.rows[0].cells[i].children[0];
                }
            }

            for (var i = 0; i < gradeArr.length; i++) {
                gradeArr[i].style.color = (i < currentvalue ? currentgradecolor : sumgradecolor)
            }
        }
    },
    GetGradeValue: function (id) {
        /// <summary>获取等级</summary>
        /// <param name="id" type="string">服务器控件uniqueid</param>
        /// <return name="callback" type="bool">等级</return>

        var gradevalue = document.getElementById(id + '_value');
        if (gradevalue == undefined)
            return -1;

        return gradevalue.value;
    }
};

源码下载：星星评分控件.zip