设置自定义ASP.NET服务器控件TagPrefix的几种方法

这两天看《道不远人-----深入解析ASP.NET2.0控件开发》这本书，看完第二章内容后，想总结下“设置自定义ASP.NET服务器控件TagPrefix的几种方法”，以便以后查阅，以下面code编写的控件为例，由于重点不是控件编写，所以写了个非常简单的控件，姑且叫它EmailInput

 

 1using System;
 2using System.Collections.Generic;
 3using System.ComponentModel;
 4using System.Text;
 5using System.Web;
 6using System.Web.UI;
 7using System.Web.UI.WebControls;
 8
 9namespace ServerControl
{
    [ToolboxData("<{0}:EmailInput runat=server></{0}:EmailInput>")]
    public class EmailInput : CompositeControl
    {
        protected RegularExpressionValidator _regValidator;
        protected RequiredFieldValidator _rqrValidatator;
        protected TextBox _input;
        protected override HtmlTextWriterTag TagKey
        {
            get
            {
                return HtmlTextWriterTag.Div;
            }
        }
        protected override void CreateChildControls() 
        {
            Controls.Clear();
            _input = new TextBox();
            _input.ID = "txtEmail";

            _rqrValidatator = new RequiredFieldValidator();
            _rqrValidatator.ID = "rqvEmail";
            _rqrValidatator.ErrorMessage = "请输入邮件地址";
            _rqrValidatator.Text = "*";
            _rqrValidatator.Display = ValidatorDisplay.Dynamic;
            _rqrValidatator.ControlToValidate = _input.ID;

            _regValidator = new RegularExpressionValidator();
            _regValidator.ID = "revEmail";
            _regValidator.Display = ValidatorDisplay.Dynamic;
            _regValidator.ErrorMessage = "邮件格式错误";
            _regValidator.Text = "*";
            _regValidator.ValidationExpression = @"\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*";
            _regValidator.ControlToValidate = _input.ID;

            this.Controls.Add(_input);
            this.Controls.Add(_rqrValidatator);
            this.Controls.Add(_regValidator);

            ChildControlsCreated = true;
        }
    }
}

 

方法一、在Web.config中配置,具体做法为:在Web.config文件的System.web节中添加如下代码

<pages>
  <controls>
     <add assembly="ServerControl" namespace="ServerControl" tagPrefix="sc"/>
  </controls>
</pages>

         说明：assembly表示控件所在的程序集名称，namespace表示控件的命名空间，tagPrefix就是我们所要设置的项了

方法二、在使用该控件的页面添加<%Register%>指令，如下

<%@ Register assembly="ServerControl" namespace="ServerControl" tagprefix="sc" %>

 说明：assembly表示控件所在的程序集名称，namespace表示控件的命名空间，tagPrefix就是我们所要设置的项了

方法三、通过装饰Attribute来指定tagPrefix，例如在控件类添加如下Attribute

[assembly: TagPrefix("ServerControl", "scsc")]
namespace ServerControl
{
    [ToolboxData("<{0}:EmailInput runat=server></{0}:EmailInput>")]
    public class EmailInput : CompositeControl
    {

说明：即使这样定义了，每个页面也都要添加<%Register%>指令，这样只是提供了统一的tagPrefix，实质上还是第二种方法

方法四、在控件项目中添加属性文件"Assembly.cs"中添加如下代码来自定义控件的前缀：

using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
using System.Web.UI;
[assembly: TagPrefix("ServerControl","scsc")]

说明：即使这样定义了，每个页面也都要添加<%Register%>指令,这样只是提供了统一的tagPrefix，实质上还是第二种方法

 

最后对上面的四种方法进行说明：

• 在Web.config中进行自定义是属于应用程序级别的定义，只注册一次即可对整个应用程序有效。其他三种方法都得在引用该控件的页面添加<%Register%>指令
• asp.net定义tagPrefix的检测顺序是：assemblyInfo.cs---->控件中的attribute装饰----->webconfig中的配置，也就是说，如果这几种方法您都设置了，那么asp.net 将会采用webconfig的设置方式！相信这也是asp.net覆盖的简单道理了！
• asp.net的自带控件采用了第一种方法，即在 web.config中进行了配置，将tagPrefix配置成了asp，如果您看着不爽，可以改掉它。

 

 

以上纯属看书心得，如有错误，恳请您指正！