在ASP.NET中使用用户控件

2020-02-03 16:37:55

字体：大中小

来源：转载

供稿：网友

菜鸟学堂：
【摘要】asp.net中提供的用户控件，可以解决asp中无法解决的代码重用问题，更方便了调试工作中的错误检查。本文通过用户控件实现方法讲解和一个用户控件例程的实现，进一步验证了利用用户控件解决代码重用的可行性和有效性。

　　【关键字】代码重用、用户控件、@register指令
　　asp.net提供了比传统asp更好的代码分离方案。在传统的asp中，要将用server. execute执行的asp文件或事务对象组件的代码分离开，一般只能将代码分离成几个文件，然后使用“include”的方法。这种方法将造成内存中有多个“include”文件的复本（文件每被引用一次就产生一个复本），从而增加了系统的负担，因此并不可行。使用server. execute或许有些改观，但是不能向正在执行的asp文件传递附加的查询串参数。使用组件可能是唯一比较好的做法。在asp.net中，除了使用“include”（并不推荐使用）和事务对象组件的方法，还可以使用两种新技术：code-behind类和web用户控件。

　　使用code-behind类可以有效地将客户端的html代码和服务器端的事件处理代码分离开。将这两部分代码分离开有利于调试时跟踪程序，因为那时就不必在实现用户界面的代码和事务逻辑代码之间来回切换。而且，如果项目中用户界面和事务处理是由不同的小组开发的，那么使用code-behind类就可以使这两部分实现独立调试。利用code-behind类将用户界面代码和事务逻辑代码区分开使得代码的集成和维护都比较简便。下面将介绍的用户控件，从代码重用的角度来处理代码分离问题。

　　1、用户控件简介

　　用户控件使程序员能够很容易地跨asp.net web应用程序划分和重复使用公共ui功能。与web窗体页相同，程序员可以使用任何文本编辑器创作用户控件，或者使用代码隐藏类开发用户控件。此外，与web窗体页一样，用户控件可以在第一次请求时被编译并存储在服务器内存中，从而缩短以后请求的响应时间。但与web窗体页不同的是，不能独立地请求用户控件，用户控件必须包括在web窗体页内才能使用。

　　与服务器端包含文件（ssi）相比，用户控件通过访问由asp.net提供的对象模型支持，使程序员具有更大的灵活性。程序员可以对在控件中声明的任何属性进行编程，而不只是包含其他文件提供的功能，这与其他任何asp.net服务器控件一样。

　　尽管在创作用户控件时需要选择一种语言，但程序员可以将多个用户控件包含在用多种语言创作的一个web窗体页中。例如，可以用visual basic.net创造一个用户控件，导入来自xml文件的数据，再用c#创建另一个用户控件，该控件包含一个订单窗体，然后在同一个web窗体页中包括这两个控件。

　　此外，可以独立于包含用户控件的web窗体页中除该控件以外的部分来缓存该控件的输出。这一技术称作片段缓存，适当地使用该技术能够提高站点的性能。例如，如果用户控件包含提出数据库请求的asp.net服务器控件，但该页的其余部分只包含文本和在服务器上运行的简单代码，则程序员可以对用户控件执行片段缓存，以改进应用程序的性能。

　　2、创建用户控件

　　可以通过使用文本或html编辑器以声明方式创建用户控件。用户控件声明语法与创建web窗体页所采用的语法十分类似；两者的主要差别在于用户控件在内容周围不包括＜html＞、＜body＞和＜form＞元素。在包含用户控件的web窗体页中包括这些元素。

　　用户控件可以像文本文件一样简单，或者它们可以包含其他asp.net服务器控件。以下过程简要介绍了一个可包括在应用程序多个页上的简单登录窗体。

　　在代码声明块中公开属性、事件处理程序以及要包括在用户控件功能中的其他任何代码。在使用用户控件的属性时有两个选择。首先，可以定义用户控件的新属性并操作它们。其次，可以操作构成用户控件的服务器控件的属性。例如，在用户控件中声明textbox web服务器控件，并向它提供一个id为password，则可以通过使用password. text语法来操作其text属性。

　　【注意】当用户控件包括在web窗体页中时，此用户控件中包含的任何asp.net服务器控件的所有属性和方法都将提升为此用户控件的公共属性和方法。

　　步骤1：以下代码示例声明映射到步骤1中代码的文本框的userid和password属性。可以通过声明或编程的方式，在任何包含此用户控件的web窗体页中操作这些属性。

public mustinherit class loginform
inherits system.web.ui.usercontrol
　protected withevents user as system.web.ui.webcontrols.textbox
　protected withevents pass as system.web.ui.webcontrols.textbox
　protected withevents button1 as system.web.ui.webcontrols.button
　#region " web 窗体设计器生成的代码 "

　'该调用是 web 窗体设计器所必需的。
　＜system.diagnostics.debuggerstepthrough()＞ private sub initializecomponent()

end sub

private sub page_init(byval sender as system.object, byval e as system.eventargs) handles mybase.init
　'codegen: 此方法调用是 web 窗体设计器所必需的
　'不要使用代码编辑器修改它。
　initializecomponent()
end sub

#end region

private sub page_load(byval sender as system.object, byval e as system.eventargs) 　handles mybase.load
　'在此处放置初始化页的用户代码
end sub
public property userid() as [string]
　get
　　return user.text
　end get
　set(byval value as [string])
　　user.text = value
　end set
end property
public property password() as [string]
　get
　　return pass.text
　end get
　set(byval value as [string])
　　pass.text = value
　end set
end property
end class
　　步骤2：创建该用户控件显示的ui元素。以下代码创建与来自步骤1的代码进行交互的登录窗体。

　　【注意】将此用户控件包括在web窗体页中时，需要在@register指令的src属性中包括此文件名称以及该文件的路径。

＜%@ control language="vb" autoeventwireup="false" codebehind="logonform.ascx.vb" inherits="logintest.logonform" targetschema="http://schemas.microsoft.com/intellisense/ie5" %＞
＜table cellspacing="15"＞
＜tr＞
＜td＞＜b＞用户姓名: ＜/b＞＜/td＞
＜td＞＜asp:textbox id="user" runat="server"＞＜/asp:textbox＞＜/td＞
＜/tr＞
＜tr＞
＜td＞＜b＞用户口令: ＜/b＞＜/td＞
＜td＞＜asp:textbox id="pass" runat="server" textmode="password"＞＜/asp:textbox＞＜/td＞
＜/tr＞
＜tr＞
＜td＞＜/td＞
＜td＞＜asp:button id="button1" runat="server" text="登录" borderstyle="groove"＞＜/asp:button＞＜/td＞
＜/tr＞
＜/table＞

　　3、调用用户控件

　　只有当包括在web窗体页中时，用户控件才可以工作。当一个请求到达某一页而该页包含用户控件时，该用户控件将经历任何服务器控件所要经历的所有处理阶段。

　　在 web 窗体页中包括用户控件的方法很简单。

　　在要包含用户控件的 web 窗体页中，声明一个@register指令，该指令包括：

　　tagprefix属性，该属性将前缀与用户控件相关联。此前缀将包括在用户控件元素的开始标记中。

　　tagname属性，该属性将名称与用户控件相关联。此名称将包括在用户控件元素的开始标记中。

　　src属性，该属性定义要包括在web窗体页中的用户控件文件的虚拟路径。

　　例如，以下代码将注册在文件loginform.ascx中定义的用户控件。该控件还被指定有标记前缀acme和标记名称login。

＜%@ register tagprefix="acme" tagname="loginform" src="./loginform.ascx" %＞

　　使用自定义服务器控件语法在htmlform服务器控件的开始标记和结束标记之间 (＜form runat=server＞＜/form＞) 声明该用户控件元素。例如，要声明在上一步导入的控件，使用以下语法。

＜%@ page language="vb" autoeventwireup="false" codebehind="logintest.aspx.vb" inherits="logintest.webform1"%＞
＜%@ register tagprefix="acme" tagname="loginform" src="./loginform.ascx" %＞
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
　＜title＞webform1＜/title＞
　＜meta name="generator" content="microsoft visual studio .net 7.0"＞
　＜meta name="code_language" content="visual basic 7.0"＞
　＜meta name="vs_defaultclientscript" content="javascript"＞
　＜meta name="vs_targetschema" content="http://schemas.microsoft.com/intellisense/ie5"＞
　＜/head＞
＜body ms_positioning="gridlayout"＞
　＜form id="form1" method="post" runat="server"＞
　　＜acme:loginform id=" loginform " runat="server"/＞
　＜/form＞＜/body＞
＜/html＞
　　【注意】无论在web窗体页上包括了多少个asp.net服务器控件（用户控件和其他任何控件），都应只在web窗体页上包括一个htmlform服务器控件。此控件的开始和结束标记之间应包括所有服务器控件。

　　通过上面的程序，在logintest.aspx页中调用了名为loginform.ascx的用户控件，结果如下图所示：

　　4、用户控件使用小结

　　（1）用户控件使开发人员能够使用编写web窗体页的相同编程技巧轻松地定义自定义控件。作为约定，用.ascx文件扩展名指示这样的控件。这样可以确保用户控件文件不能作为独立的web窗体页执行。

　　（2）用户控件通过register指令包括在另一web窗体页中，该指令指定tagprefix、tagname和src location。

　　（3）注册了用户控件后，可以像普通的服务器控件那样将用户控件标记放置在web窗体页中（包括runat="server"属性）。在包含web窗体页中将用户控件的公共字段、属性和方法提升为该控件的公共属性（标记属性）和方法。

　　（4）用户控件参与每个请求的整个执行生存期，并且可以处理自己的事件，封装来自包含web窗体页的一些页逻辑。

　　（5）用户控件不应包含任何窗体控件，而应依靠其包含web窗体页在必要时包括窗体控件。

　　（6）可以使用system.web.ui.page类的loadcontrol方法以编程方式创建用户控件。用户控件的类型由asp.net运行库决定，遵循约定文件名_扩展名。

　　（7）只有当为用户控件包括了register指令时，用户控件的强类型才能由包含web窗体页使用（即使没有实际声明的用户控件标记）。

　　5、结束语

　　在编写web应用程序时，如果将可能重复出现的元素都用用户控件来实现，那将大大减少维护代码的代价。而且在修改代码时，记得修改一段代码却忘了修改另一段同样代码的情况也将不存在了。代码越短，出现错误的因素越少，出现错误的可能性就越小。

上一篇：在ASP.NET中实现多页面选择的问题

下一篇：ASP.NET中实现模版的动态加载