编写ASP.NET复合控件实例

 

编写ASP.NET复合控件实例

在ASP.NET中，我们可以使用CompositeControl类来派生一系统的复合控件，并将其编译到DLL中，以便以后实现控件重用，下面就以Loggin控件为例，对复合控件的开发过程进行说明。

大家如果有什么问题，请给本人发送Email：warensoft@163.com

1.        在VS2010中新建一个项目，选择Web模板，在Web模板中选择ASP.NET Server Control，如下图所示：

2.        VS IDE会为我们自动添加一个ServerControl1类，将该文件名以及类名改为Login，如下图所示：

代码中第12行的“DefaultProperty”特性，是指明当该控件被拖放到设计器中，并且被选中时，被控件的默认具备高亮提示的属性是Text属性。

第13行的“ToolboxData”特性，是指明当该控件被拖放到VS的设计器中，在HTML代码视图中所显示的文本内容，为了让该内容中显示的控件名和该控件类的类名相同，将该行代码做如下修改：

[ToolboxData("<{0}:Loggin runat=server>")]

其中是占位符，在最终拖放在设计器中时，会被该控件的命名空间所代替。

第16行的”Bindable”特性，是指明该属性是否可以在绑定设计器可见，true为可见，False为不可见，但是这个时我们仍然可以在ASPX页面里直接将该属性与绑定表达式进行关联，比较手动输入Eval（）语句。比如说，我们将该控件放在了一个GridView的模板列里，如果想让该属性绑定到“CustomerID”字段上，如果设置Bindable(true)，那么我们可以绑定设计器看到该Text属性，如下图所示：

如果将其设置为false，那么我们就只在ASPX页面中手动编写Eval(“CustomerID”)表达示。

第17行的Category特性，是指将该Text属性应该位于属性窗口的哪一个分组里。上面代码中设置的Category的值是“Appearence”,这就意味着，将该控件拖放到VS的设计器中以后，并查看该控件的属性，如果属性窗口的显示排列方式是按分类方式排列，些时，Text属性就会出现在Appearance分组栏中，如下图所示：

第18行“DefaultValue”特性用来设置该属性的默认值。

第19行“Localizable”特性，是该属性是否可以自动查找本地化资源文件以进行本地化。

3.        前面对代码中的特性类进行了简要的分析，下面我们要对代码进行修改。首先，要想将我们的Login控件变为复合控件，就要将该控件类的基类修改为CompositeControl类，为复合控件中添加子控件，主要是通过重写基类的CreateChildControl方法来实现的，下面代码实现为Login控件添加了控件的功能：

    ///

    /// 用来输入用户名的文本框

    ///  

    private TextBox tbxUserName;

    ///

    /// 用来输入密码的文本框

    ///  

    private TextBox tbxPassword;

    ///

    /// 用来提交的确认按钮

    ///  

    private Button bt;

    protected override void CreateChildControls()

    {

        //清空原有的子控件

        this.Controls.Clear();

        //初始化新的子控件

        this.tbxUserName = new TextBox();

        this.tbxPassword = new TextBox();

        this.tbxPassword.TextMode = TextBoxMode.Password;

        this.bt = new Button();

        //注册Button的Click事件

        this.bt.Click += new EventHandler(bt_Click);

        bt.Text = "log in";

 

        //以Table的方式为这些子控件进行布局

        Table table = new Table();

        TableCell cell00 = new TableCell();

        cell00.Text = "user name:";

        TableCell cell01 = new TableCell();

        cell01.Controls.Add(this.tbxUserName);

 

        TableRow row0 = new TableRow();

        row0.Cells.Add(cell00);

        row0.Cells.Add(cell01);

 

        TableCell cell10 = new TableCell();

        cell10.Text = "password:";

        TableCell cell11 = new TableCell();

        cell11.Controls.Add(this.tbxPassword);

 

        TableRow row1 = new TableRow();

        row1.Cells.Add(cell10);

        row1.Cells.Add(cell11);

 

 

        TableCell cell20 = new TableCell();

        cell20.ColumnSpan = 2;

        cell20.Controls.Add(this.bt);

        TableRow row2 = new TableRow();

        row2.Cells.Add(cell20);

 

        table.Rows.Add(row0);

        table.Rows.Add(row1);

        table.Rows.Add(row2);

 

        //将新建立的Table添加到子控件的集合中

        this.Controls.Add(table);

        //通知该控件所以的子控件已经创建完毕

        this.ChildControlsCreated = true;

 

 

        base.CreateChildControls();

    }

 

    //当用户登录验证完毕之后触发

    public event EventHandler UserLoggedIn;

 

    void bt_Click(object sender, EventArgs e)

    {

        var conStr = ConfigurationManager.ConnectionStrings["testConnectionString"].ConnectionString;

        using (SqlConnection con = new SqlConnection(conStr))

        {

            var cmd = con.CreateCommand();

            cmd.CommandText = "select count(*) from users where uid=@uid and pwd=@pwd";

            cmd.Parameters.Add("@uid", SqlDbType.NVarChar, 50).Value = this.tbxUserName.Text;

            cmd.Parameters.Add("@pwd", SqlDbType.NVarChar, 50).Value = this.tbxPassword.Text;

            con.Open();

            int count = (int)cmd.ExecuteScalar();

            if (this.UserLoggedIn != null)

            {

                bool result = count == 0 ? false : true;

                this.UserLoggedIn(this, new UserLoggedInEventArgs() { Validated = result });

            }

        }

}

4.        验证该控件的功能

首先，在解决方案中添加一个网站，然后编译前面的控件库，此时，我们会在工具箱里看到刚才编写的控件，如下图所示：

将其拖动到设计器，如下图所示：

在该控件中我们所添加的自定义事件如下图所示：

5.        由些看来，编写基本的自定义复合控件还是比较简单的，但是我在编写代码的同时，也会发现，由于没有设计器辅助支持，自定义复合控件的界面是一件比较麻烦的事情，程序员只能凭借自己的直观记忆和美工指定的数值化参数来设计。

          6. 该控件类的完整代码如下所示：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Linq;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Configuration;
using System.Data.SqlClient;
using System.Data;

namespace MyControlLib
{
    [DefaultProperty("Text")]
    [ToolboxData("<{0}:Loggin runat=server></{0}:Loggin>")]
    public class Loggin : CompositeControl
    {
        [Description("this is the event")]
        public event EventHandler<UserLoggedInEventArgs> UserLoggedIn;


        /// <summary>
        /// 用来输入用户名的文本框
        /// </summary>
        private TextBox tbxUserName;
        /// <summary>
        /// 用来输入密码的文本框
        /// </summary>
        private TextBox tbxPassword;
        /// <summary>
        /// 用来提交的确认按钮
        /// </summary>
        private Button bt;
        protected override void CreateChildControls()
        {
            //清空原有的子控件
            this.Controls.Clear();
            //初始化新的子控件
            this.tbxUserName = new TextBox();
            this.tbxPassword = new TextBox();
            this.tbxPassword.TextMode = TextBoxMode.Password;
            this.bt = new Button();
            //注册Button的Click事件
            this.bt.Click += new EventHandler(bt_Click);
            bt.Text = "log in";

            //以Table的方式为这些子控件进行布局
            Table table = new Table();
            TableCell cell00 = new TableCell();
            cell00.Text = "user name:";
            TableCell cell01 = new TableCell();
            cell01.Controls.Add(this.tbxUserName);

            TableRow row0 = new TableRow();
            row0.Cells.Add(cell00);
            row0.Cells.Add(cell01);

            TableCell cell10 = new TableCell();
            cell10.Text = "password:";
            TableCell cell11 = new TableCell();
            cell11.Controls.Add(this.tbxPassword);

            TableRow row1 = new TableRow();
            row1.Cells.Add(cell10);
            row1.Cells.Add(cell11);


            TableCell cell20 = new TableCell();
            cell20.ColumnSpan = 2;
            cell20.Controls.Add(this.bt);
            TableRow row2 = new TableRow();
            row2.Cells.Add(cell20);

            table.Rows.Add(row0);
            table.Rows.Add(row1);
            table.Rows.Add(row2);

            //将新建立的Table添加到子控件的集合中
            this.Controls.Add(table);
            //通知该控件所以的子控件已经创建完毕
            this.ChildControlsCreated = true;


            base.CreateChildControls();
        }

        void bt_Click(object sender, EventArgs e)
        {
            var conStr = ConfigurationManager.ConnectionStrings["testConnectionString"].ConnectionString;
            using (SqlConnection con = new SqlConnection(conStr))
            {
                var cmd = con.CreateCommand();
                cmd.CommandText = "select count(*) from users where uid=@uid and pwd=@pwd";
                cmd.Parameters.Add("@uid", SqlDbType.NVarChar, 50).Value = this.tbxUserName.Text;
                cmd.Parameters.Add("@pwd", SqlDbType.NVarChar, 50).Value = this.tbxPassword.Text;
                con.Open();
                int count = (int)cmd.ExecuteScalar();
                if (this.UserLoggedIn != null)
                {
                    bool result = count == 0 ? false : true;
                    this.UserLoggedIn(this, new UserLoggedInEventArgs() { Validated = result });
                }
            }
        }
    }
}