将ASP.NET用户控件转化为自定义控件

原创 2006年06月23日 00:28:00

  将ASP.NET用户控件转化为自定义控件

 作者:sugar | 标签:C# | 浏览(389) | 评论(0) | 03-13 10:43

 

作者:Kevin Cheng (程建和)
最后修改时间:2006-03-12
概述:如何将ASP.NET用户控件移植为ASP.NET自定义控件
关键字:Asp.net, 用户控件, 自定义控件
本文适用读者:
   - 熟悉aspnet,能创建ascx用户控件
   - 想创建自定义控件,而又为其庞杂的实现方法而惧的读者
相关下载:
   - 本文使用的ascx控件例程: WebFtp060308(pm06).rar
   - 本文使用的自定义控件例程: WebFtp 1.0.2259.39656.rar
术语声明:
    Field       类成员变量
    Property    类属性
    Attribute   类特性
    NameSpace   命名空间
 

引言: 
    asp.net自定义控件使用起来相当方便,但相对ascx用户控件而言,由于其没有可视化编程支持,编写时相当困难。
    有没有简单的办法呢?既可以使用ascx可视化编程的优点,又可以发挥自定义控件使用方便的特点。
    本文介绍一种解决方案:先设计好ascx控件,再转化为用户控件。 以下为具体步骤。
    
   
一、创建ascx控件,并调试通过 
   
    具体怎么创建ascx用户控件不是本文的重点,跳过啦~
    本文使用到的ascx例程可点击此处 下载。该例程创建了一个web文件管理的ascx控件。效果如:
       

二、将ascx移植为自定义控件 

    (一)新建工程aspnet自定义控件工程,将原ascx类中的所有cs代码都拷贝到自定义控件类中去
    (二)修改InitializeComponent()函数以初始化控件。可将其扩充为三个小函数,如: 

private void InitializeComponent()  
{  
    CreateComponent();  
    SetComponentProperty();  
    SetComponentEvent();  
}  
其中  
1)CreateComponent()函数用于新建出所有使用到的控件,并组织好其层次关系  
    
private void CreateComponent()  
    {  
        
// create  
        lblCurrPath = new Label();  
        lblUpload 
= new Label();  
        lblNewFolder 
= new Label();  
        
          
        
// nest  
        Controls.Add(this.lblCurrPath);  
        Controls.Add(
new HtmlGenericControl("br"));  
        
this.panAdmin.Controls.Add(this.file);  
        
    }  
2)SetComponentProperty()函数用于设置这些控件的属性,如  
    
private void SetComponentProperty()  
    {  
        lblCurrPath.Font.Size 
= FontUnit.XLarge;  
        lblCurrPath.CssClass 
= "webftp_title";  
        panInfo.BackColor 
= Color.Yellow;  
        panInfo.Visible 
= false;  
        
    }
    值得注意的是,aspnet提供的组合绑定控件(如DataGrid, DataList..)的属性设置较为复杂,参见附录二 
3)SetComponentEvent()函数中设置控件的事件句柄,这个从原有的InitializeComponent函数中拷贝过来就可,如 
private void SetComponentEvent()  
{  
    
this.btnUpload.Click += new System.EventHandler(this.btnUpload_Click);  
    
this.btnNewFolder.Click += new System.EventHandler(this.btnNewFolder_Click);  
    
this.dg.ItemCommand += new System.Web.UI.WebControls.DataGridCommandEventHandler(this.dg_ItemCommand);  
    
this.Load += new System.EventHandler(this.Page_Load);  
    


      (三)填充Render()函数用以渲染输出效果。可将其扩展为两个小函数,如 

protected override void Render(HtmlTextWriter output) 

    RenderClientScript(output); 
    RenderServerComponent(output); 

其中 
1)RenderClientScript函数可用于输出客户端脚本,以及样式style代码,如: 
    
private void RenderClientScript(HtmlTextWriter output) 
    { 
        output.Write(
"<style>{0} {1}</style>""A { TEXT-DECORATION: none }""A:hover { TEXT-DECORATION: underline }"); 
         
    } 
2)RenderServerComponent函数用于输出各控件,也可在此添加一些普通html代码的输出,如 
    
private void RenderServerComponent(HtmlTextWriter output) 
    { 
        
this.lblCurrPath.RenderControl(output); 
        output.Write(
"<hr width=100% size=1 color=darkgray>"); 
        
this.panAdmin.RenderControl(output); 
        
this.dg.RenderControl(output); 
    } 

            
    (四)让类实现INamingContainer接口,以避免页面上放置多个该控件而导致子控件id冲突的情况
        该接口无任何函数,只需声明实现就可,如

public class WebFtp : System.Web.UI.WebControls.WebControl, INamingContainer 

        只要让类实现该接口,系统将自动实现避免id冲突的方法
        具体步骤是将内部控件id名前都附上父控件的id。如在panel(id=pan)中有一个lable(id=lblName),那么label的id会给自动改为pan_lblName;
     至此,编译调试成功后,该控件就可以使用了。再加上图片,效果可以是这样:
       
    

三、商业标准化自定义控件 

    第二步完成后,该控件已经可以使用了(如何使用?晕,请看附录五),但其还是一个粗胚,例如没有控件图标,没有设计时外观等。
    以下将介绍如何修饰该控件,令其像个标准化的商业控件。
    (1)为控件的属性添加例如类别、描述、默认值等Attribute特性
        这些特性将影响到控件在属性工具栏中的内容
        格式如:[Bindable(true), Category("类别"), Description("描述信息"), DefaultValue("缺省字符串类型值")]
        常用的Attribute有: 

CategoryAttribute               属性类别 
BrowsableAttribute              属性可否显示 
DefaultPropertyAttribute        控件的缺省属性 
DefaultValueAttribute           属性的缺省值 
DescriptionAttribute            属性的描述信息 
ReadOnlyAttribute               属性是否只读 
BindableAttribute               属性是否可绑定 
NotifyParentPropertyAttribute   修改该属性后是否通知控件 

        更多的Attribute 请查阅附录三、附录、以及 System.ComponentModel 命名空间
    (2)添加工具栏图标
        为类添加特性:[ToolboxBitmap(typeof(WebFtp), "Kingsoc.Web.Controls.WebFtp.bmp")]
        其中要注意的是:
        - 项目的默认命名空间为Kingsoc.Web.Controls
        - 图片名称为webftp.bmp,并需要设置其编译选项为“嵌入的资源”
        这样工具栏上图标就变成这样咯~:
    (3)添加设计时外观支持
        为类添加特性:[Designer(typeof(Kingsoc.Web.Controls.WebFtpDesigner))]
        其中,类 Kingsoc.Web.Controls.WebFtpDesigner 继承至ControlDesigner,用于绘制设计时的控件外观,如: 

        using System; 
        
using System.Web.UI; 
        
using System.Web.UI.WebControls; 
        
using System.ComponentModel; 
        
using System.ComponentModel.Design; 
        
using System.Web.UI.Design; 
        
using System.Text; 
        
namespace Kingsoc.Web.Controls 
        { 
         
public class WebFtpDesigner : ControlDesigner 
         { 
                
public override string GetDesignTimeHtml() 
                { 
                    
//return base.GetDesignTimeHtml (); 
                    WebControl ctrl = (WebControl)this.Component; 
                    StringBuilder sb 
= new StringBuilder(); 
                    sb.AppendFormat( 
                        
"<label style='align:center; valign:middle; font-size:small; font-family: Arial; background-color: #eeeeee; padding:2px; border:2px dotted gray; width:{0}; height:{1};'><center>{2}</center></lable>"
                        ctrl.Width, 
                        ctrl.Height, 
                        ctrl.ID); 
                    
return sb.ToString(); 
                } 
        
                
public override bool AllowResize 
                { 
                    
get {return true;} 
                } 
         } 
        } 

        这样,设计时控件就有了外观支持:
        (嫌太简陋?自己用dreamweaver等设计工具设计,想多好看就多好看!再拷贝html代码到GetDesignTimeHtml()函数内部去)
     (4)添加TagPrefix
        用于指定将控件从工具栏中拖放到窗体中,自动生成的控件名称前缀(实际上是控件所属的命名空间的别名)
        在AssemblyInfo.cs文件中添加:[assembly: TagPrefix("Kingsoc.Web.Controls", "ks")]
        这样,添加了该控件的web窗体就会自动生成类似代码

<%@ Register TagPrefix="ks" Namespace="Kingsoc.Web.Controls" Assembly="Kingsoc.Web.Controls.WebFtp" %>
<ks:WebFtp id="webFtp" runat="server"></ks:WebFtp>

     (5)设置版权信息
        修改AssemblyInfo.cs文件中的以下特性 

[assembly: AssemblyTitle("")] 
[assembly: AssemblyDescription(
"")] 
[assembly: AssemblyConfiguration(
"")] 
[assembly: AssemblyCompany(
"Kingsoc software")] 
[assembly: AssemblyProduct(
"")] 
[assembly: AssemblyCopyright(
"")] 
[assembly: AssemblyTrademark(
"Kingsoc")] 
[assembly: AssemblyCulture(
"")] 

     (6)将控件添加到GAC中。见附件五
     (7)添加控件注册保护。见附件六 
     


--------------------------------------------------------------------       
附录
--------------------------------------------------------------------    
附录一:自定义控件基类的选择 
    Control     所有web控件的基类
    WebControl  继承至Control类,并添加了例如Width,Height等属性,这是常用且默认的基类,常用于有外观的控件
    Component   常用于无外观的控件,例如:数据访问控件
    故,对于组合控件,一般使用WebControl作为基类。而对于无界面的控件,一般使用Component就可以了

附录二:用代码创建DataGrid绑定列 
    (1)普通绑定列 

BoundColumn col = new BoundColumn(); 
col.DataField 
= "name"
col.ReadOnly 
= true
dg.Columns.Add(col); 

    (2)模板绑定列 

TemplateColumn col = new TemplateColumn(); 
col.ItemTemplate 
= new LinkButtonTemplate("btnName""name""Select"); 
col.EditItemTemplate 
= new TextBoxTemplate("txtName""name"); 
dg.Columns.Add(col); 
其中LinkButtonTemplate和TextBoxTemplate模板代码如下: 
// LinkButton模板 
public class LinkButtonTemplate : ITemplate 

    
string _id; 
    
string _bindField; 
    
string _commandName; 

    
public LinkButtonTemplate(string id, string bindField, string commandName) 
    { 
        _id 
= id; 
        _commandName 
= commandName; 
        _bindField 
= bindField; 
    } 
    
public void InstantiateIn(Control container) 
    { 
        LinkButton ctrl 
= new LinkButton(); 
        ctrl.ID 
= _id; 
        ctrl.CommandName 
= _commandName; 
        ctrl.DataBinding 
+= new EventHandler(this.BindData); 
        container.Controls.Add(ctrl); 
    } 
    
void BindData(object sender, System.EventArgs e) 
    { 
        LinkButton ctrl 
= sender as LinkButton; 
        ctrl.Text 
= DataBinder.Eval(ctrl.NamingContainer, "DataItem." + _bindField).ToString(); 
        
//或 ctrl.Text = ((ctrl.NamingContainer as DataGridItem).DataItem as DataRowView)[_bindField].ToString(); 
    } 


// TextBox模板 
public class TextBoxTemplate : ITemplate 

    
string _id; 
    
string _bindField; 

    
public TextBoxTemplate(string id, string bindField) 
    { 
        _id 
= id; 
        _bindField 
= bindField; 
    } 
    
public void InstantiateIn(Control container) 
    { 
        TextBox ctrl 
= new TextBox(); 
        ctrl.ID 
= _id; 
        ctrl.DataBinding 
+= new EventHandler(this.BindData); 
        container.Controls.Add(ctrl); 
    } 
    
void BindData(object sender, System.EventArgs e) 
    { 
        TextBox ctrl 
= sender as TextBox; 
        ctrl.Text 
= DataBinder.Eval(ctrl.NamingContainer, "DataItem." + _bindField).ToString(); 
    } 



附录三:自定义控件可用的特性(Attribute) 
    System.ComponentModel 命名空间提供用于实现组件和控件运行时和设计时行为的类。
    此命名空间包括用于实现属性和类型转换器、绑定到数据源以及授权组件的基类和接口。
        CategoryAttribute
        BrowsableAttribute
        DefaultPropertyAttribute
        DefaultValueAttribute
        DescriptionAttribute
        ReadOnlyAttribute
        NotifyParentPropertyAttribute
       
        AmbientValueAttribute
        BindableAttribute
        DefaultEventAttribute
        DesignerAttribute
        DesignerCategoryAttribute
        DesignerSerializationVisibilityAttribute
        DesignOnlyAttribute
        DesignTimeVisibleAttribute
        EditorBrowsableAttribute
        ImmutableObjectAttribute
        InheritanceAttribute
        InstallerTypeAttribute
        LicenseProviderAttribute
        ListBindableAttribute
        MergablePropertyAttribute
        ParenthesizePropertyNameAttribute
        ProvidePropertyAttribute
        RecommendedAsConfigurableAttribute
        RefreshPropertiesAttribute
        RunInstallerAttribute
        ToolboxItemAttribute
        ToolboxItemFilterAttribute
        TypeConverterAttribute 
    
   
附录四:关于DefaultValue特性
    只用于检测用户输入值是否与该值相同,若相同,则不会在asp页面代码中显示出该属性值;反之则显示。实际并没有修改该属性的值!
    例如,对于以下语句,AttachTimeStampToUploadedFile 应该等于构造函数中指定的true,而非DefaultValue中提供的false 

[DefaultValue(false)] 
public bool AttachTimeStampToUploadedFile 

    
get {return _AttachTimeStampToUploadedFile;} 
    
set {_AttachTimeStampToUploadedFile = value;} 

public WebFtp() 

    AttachTimeStampToUploadedFile 
= true

    所以,设置默认值时应该确保与初始化值相同,否则会带来令人困惑的结果。要么干脆就不写。

附录五:如何将自定义控件添加到工具栏 
    (1)在工具栏面板中点击右键,点击”添加/移除项..."
    (2)在弹出的“自定义工具箱”对话框中点击“浏览”按钮,选择自定义控件dll文件
    (3)点击确定,关闭对话框。控件图标将显示在工具栏面板上

附录六:将控件添加到GAC中 
     未完成

附录七:添加控件注册保护 
     未完成

--------------------------------------------------------------------       
参考文章
--------------------------------------------------------------------       
《ASP.NET组件设计指南》

相关文章推荐

asp.net 避免用户自定义控件的父类代码多次运行

在一个asp.net项目中,用户自定义控件是很经常使用的,一个项目中一般都会有多个用户自定义控件,而为了代码重用,通常这些控件都会继承一个父类, 一个页面还会引用多个用户自定义控件。 这种情况如果...

ASP.NET MVC 重点教程一周年版 第十一回 母版页、用户自定义控件及文件上传

母版页(Master) 1.母版页是与Controller无关的,母版页只是一个View文件,而没有任何Controller与之相对应。 2.其实在ASP.NET MVC中View的aspx与母版...

ASP.NET分页存储过程自定义用户控件

网上有很多分页存储过程,但是基本上都是提供一个单纯的存储过程,没有具体的怎样去实现。最近做一个项目用户的数数据相当大(一百万以上 的数据),如果用.NET自带的分页基本上是跑不动了,不是提示超时就是死...
  • my98800
  • my98800
  • 2016年04月18日 08:42
  • 145

asp.net WebForm之用户自定义控件

关于用户自定义控件,想必大家已经非常熟悉了。虽然说经常用过,但是只是简单的使用而已。在这里再次总结一下Asp.net中的UserControl,以便下次使用时 能够得心应手。本文将会介绍以下内容...

转Asp.net 用户控件添加自定义事件

转Asp.net 用户控件添加自定义事件 对于用户控件的使用有这样的特点。就是,当我们要求一个用户控件要实现特定的功能的时候,他可以在整个网站里面的页面上任意拖拽。但是,他的功能相对固定,也就是说在...

asp.net用户自定义控件的方法

.ascx代码如下:

ASP.NET自定义用户控件

用户登录 用户名: ' ID="RequiredFieldValidatorTxtUserName" runat="server"...

ASP.NET用户控件和自定义控件

  • 2009年04月17日 15:45
  • 95KB
  • 下载

【asp.net】用户控件&自定义控件

在原来的学习中,从vb到asp.net我们都接触了很多的控件,这些控件为我们的程序开发提供了很多的便利,在程序开发中,许多功能或代码都需要重复的使用,我们在牛腩的时候学习了模板方法和重复代码添加工具箱...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:将ASP.NET用户控件转化为自定义控件
举报原因:
原因补充:

(最多只允许输入30个字)