自定义服务器控件

王朝学院·作者佚名  2016-05-21
窄屏简体版  字體: 小  |  中  |  大  |  超大  

asp.net自定义服务器控件本文通过创建一个最简单的服务器控件,演示开发服务器端控件的流程。

文章内容整理自MSDN的编程指南,原文地址在文章末尾的资源中。

本文创建一个简单的服务器控件,名为 RedLabel。 它的使用方式为:

?1

<f:redlabel text="this is a test !" runat="server"></f:redlabel>

这个标签会将自己的Text属性值以红色的样式输出到页面上。运行结果如图所示:

步骤

新建一个空白解决方案,在此解决方案下新建一个类库项目,名称为MyControl。在类库中新建一个服务器端控件,名称为RedLabel。如图所示:

打开RedLabel类,将整个类的代码修改为:

?12345678910111213141516171819202122

using System;using System.Collections.Generic;using System.ComponentModel;using System.Text;using System.Web;using System.Web.UI;using System.Web.UI.WebControls;namespace MyControl{[DefaultPRoperty("Text")][ToolboxData("<{0}:RedLabel runat=server><!--{0}:RedLabel-->")]public class RedLabel : Label {//重写RenderContent函数,输出控件内容protected override void RenderContents(HtmlTextWriter output){//将自己的Text属性(继承自Label类)值使用红色样式输出output.Write("<div style="color:red">" + Text + "</div>");}}}

至此自定义label控件编写完毕。

配置程序集属性

1. 打开类库项目下的程序集属性文件:AssemblyInfo.cs,如图所示:

1. 在文件开头添加下面代码:

?1

<strong>using System.Web.UI;</strong>

2. 在文件末尾添加下面的代码:

?1

<strong> [assembly: TagPrefix("MyControl", "f")]</strong>

其中MyControl是命名空间的名称。f是自定义控件的标签前缀。

代码说明如果控件要呈现在客户端浏览器中不可见的元素(如隐藏元素或meta元素),则应从 System.Web.UI.Control 派生该控件。 WebControl 类从 Control 派生,并添加了与样式相关的属性,如 Font、ForeColor 和 BackColor。 另外,自定义控件通过重写 RenderContents 方法将文本写入响应流中。

在页面中使用自定义控件要在页面中使用自定义控件,需要事先进行注册,注册的目的是将控件的前缀和命名空间进行映射,这样就能通过标签名找到标签对应的实现类。注册的方式有两种

1.在页面中使用@ Register指令,如以下示例所示:

?1

<%@ RegisterAssembly="ServerControl" TagPrefix="aspSample” Namespace="ServerControl"%>

2.在 Web.config文件中指定标记前缀/命名空间映射。 如果将在 Web应用程序的多个页中使用自定义控件,则该方法非常有用。 下面的示例显示了一个 Web.config文件,该文件指定了程序集MyControl中命名空间MyControl和标签前缀f的映射。

?1

?1234567891011

<!--?xml version="1.0"?--><configuration><system.web> <pages><controls></add></controls></pages></system.web></configuration>

测试控件

在解决方案下新建web项目,在web项目中新建apsx页面,在页面中引入自定义控件(注意,控件前缀需要注册)。比如以下页面:

?1234567891011121314151617

<%@ Page Language="C#"AutoEventWireup="true"CodeBehind="Default.aspx.cs"Inherits="MyControl.Web._Default" %><%@ Register Assembly="MyControl"TagPrefix=java s

 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
 
© 2005- 王朝網路 版權所有 導航