Custom Controls and User Controls

最新推荐文章于 2024-11-06 20:52:22 发布

xiaogang3438792

最新推荐文章于 2024-11-06 20:52:22 发布

阅读量520

点赞数

文章标签： user asp.net microsoft textbox web server

本文链接：https://blog.csdn.net/xiaogang3438792/article/details/4344970

版权

概述

什么是用户控件？
什么是自定义控件？
用户控件和自定义控件进行基本的区别是什么？

我还将介绍几个涉及诸如状态管理和自定义控件的呈现之类的自定义控件的高级主题。

回到顶端

什么是用户控件？

介绍 Web 窗体页
http://msdn2.microsoft.com/en-us/library/65tcbxz3(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/65tcbxz3(vs.71).aspx)

Web 窗体代码模型
http://msdn2.microsoft.com/en-us/library/015103yb(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/015103yb(vs.71).aspx)

如何创建用户控件

打开文本或 HTML 编辑器，并创建服务器端代码块公开所有属性、方法和事件。

 <script language="C#" runat="server">
   public void button1_Click(object sender, EventArgs e)
   {
      label1.Text = "Hello World!!!";
   }
</script>

创建用户控件在用户界面。

 <asp:Label id="label1" runat="server"/>
 <br><br>
<asp:button id="button1" text="Hit" OnClick="button1_Click" runat="server" />

如何在 Web 窗体页中使用用户控件

在 Microsoft Visual Studio.NET 2002、 Microsoft Visual Studio.NET 2003、 Microsoft Visual Studio 2005 或任何文本编辑器中创建新的 Web 窗体页 (.aspx)。
声明 @ Register 指令。是例如使用下面的代码。
<%@ Register TagPrefix="UC" TagName="TestControl" Src="test.ascx" %>
请注意 采用用户控件和 Web 窗体页位于同一位置。

Web 窗体页中使用用户控件，请 @ Register 指令后使用以下代码。

 <html>
    <body>
          <form runat="server">
               <UC:TestControl id="Test1" runat="server"/>
          </form>
    </body>  
</html>

如何在代码隐藏文件在 Web 窗体页中的以编程方式创建用户控件的实例

在 Visual Studio 中创建新的 Web 窗体页。
定位到代码隐藏文件生成为此 Web 窗体页。
Page 类的 Page _ Load 事件中, 写入以下 code.
// Load the control by calling LoadControl on the page class. Control c1 = LoadControl("test.ascx"); // Add the loaded control in the page controls collection. Page.Controls.Add(c1);
Page.controls.Add(c1)，说明您可以将用户控件添加动态在页生命周期的某些事件。

有关详细信息，请访问下面的网站：
以编程方式向 Web 窗体页添加控件
http://msdn2.microsoft.com/en-us/library/kyt0fzt1(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/kyt0fzt1(vs.71).aspx)

控件执行生命周期
http://msdn2.microsoft.com/en-us/library/aa719775(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/aa719775(vs.71).aspx)

动态的 Web 控件、回发，和视图状态的 Scott Mitchell
http://aspnet.4guysfromrolla.com/articles/092904-1.aspx (http://aspnet.4guysfromrolla.com/articles/092904-1.aspx)

如何处理用户控件

页面分析程序分析 @ Register 指令中 Src 属性中指定的.ascx 文件，并生成从 System.Web.UI.UserControl 类派生的类。
解析程序然后动态编译类为程序集。
如果您使用 Visual Studio，然后在仅设计时，Visual Studio 创建一个代码隐藏文件在用户控件，并由本身设计预编译该文件是。
最后，类为用户控件生成完成动态代码生成和编译的过程包括代码隐藏文件代码 (ascx.cs）以及.ascx 文件中编写的代码。

回到顶端

什么是自定义控件？

如何选择自定义控件的基类

如果您希望在控件呈现派生自非可视元素则应从 System.Web.UI.Control 中进行派生。例如 <meta> <head> 是派生自非可视呈现的示例。
如果您希望以呈现生成一个 Visual 接口在客户端计算机上的 HTML 控件则应从 System.Web.UI.WebControls.WebControl 中进行派生。

如果您想要更改如按钮或标签，之类的现有控件的功能您可以直接派生新类与这些现有的类，并可以更改其默认行为。

简要， Control 类提供了基本的功能，通过它您可以放置它 Page 类的控件树中。 WebControl 类将功能添加到基本的控件类，用于在客户端计算机上显示 Visual 的内容。是例如可以使用 WebControl 类控件的外观和样式属性（如字体、颜色和高度。

如何创建和使用从 System.Web.UI.Control 扩展使用 Visual Studio 的简单自定义控件

启动 Visual Studio。
创建一个类库项目然后赋予它一个的名称是例如 CustomServerControlsLib。
将受源代码文件添加到项目，是例如 SimpleServerControl.cs。
System.Web 命名空间的引用纳入参考部分中。

检查是否将以下命名空间包括 SimpleServerControl.cs 文件

 System
System.Collections
System.ComponentModel
System.Data
System.Web
System.Web.SessionState
System.Web.UI
System.Web.UI.WebControls

中。

继承控件的基类 SimpleServerControls 类。
public class SimpleServerControl : Control
重写 Render 方法将输出写入输出流。
protected override void Render(HtmlTextWriter writer) { writer.Write("Hello World from custom control"); }
请注意 HtmlTextWriter 类具有 HTML 写入文本 Stream 的功能。 Write 方法 HtmlTextWriter 类的输出指定的文本到 HTTP 响应流， Response.Write 方法相同。
编译类库项目。它将生成 DLL 输出。
打开现有或创建新的 ASP.NET Web 应用程序项目。
添加一个 Web 窗体页，可以在其中使用自定义的控件。
ASP.NET 项目的参考部分中添加对该类库的引用。

 <%@ Register TagPrefix="CC " Namespace=" CustomServerControlsLib " Assembly="CustomServerControlsLib " %>

要实例化，或使用 Web 窗体页上自定义的控件，将代码的下行添加在 <form> 标记中。
<form id="Form1" method="post" runat="server"> <CC:SimpleServerControl id="ctlSimpleControl" runat="server"> </CC:SimpleServerControl > </form>
注意在此代码， SimpleServerControl 是在该类库控件类名）。
运行在 Web 窗体页，并您将会看到自定义控件输出。

如果要不 Visual Studio 使用需要执行以下步骤：

打开任何文本编辑器。
创建一个名为 SimpleServerControl.cs 的文件并编写该的代码，以指定在步骤 1 至 14。
在 PATH 变量中添加下面的路径：
c:/windows (Winnt)/Microsoft.Net/Framework/v1.1.4322
打开一个命令提示符窗口，然后转到存在 SimpleServerControl.cs 所在的位置。
运行以下命令：
csc /t:library / out: CustomServerControlsLib。 SimpleServerControl.dll /r:System.dll /r:System.Web.dll SimpleServerControl.cs
有关 C# 编译器 (csc.exe)，请访问下面的 MSDN 网站：
http://msdn2.microsoft.com/en-us/library/1700bbwd(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/1700bbwd(vs.71).aspx)
若要运行 Web 窗体页上自定义的控件，执行以下操作：
1. 创建一个在 Wwwroot 文件夹下的目录。
2. 启动 Microsoft Internet Information Services (IIS) 管理器，并在新目录标记为虚拟根目录。
3. 创建一个新的目录下的 Bin 文件夹。
4. 将自定义控件 DLL 复制到文件夹中。
5. 将以前的步骤，在新的目录中创建示例 Web 窗体页。
6. 运行示例页通过 IIS 管理器。

既然您所生成简单的自定义控件，让我们来看一下如何公开属性，并应用该自定义控件上的设计时属性。

如何公开自定义控件上的属性

在文本编辑器中打开 SimpleServerControl.cs。

SimpleServerControl 类中添加属性。

 public class SimpleServerControl : Control
{
   private int noOfTimes;
   public int NoOfTimes
   {
       get { return this.noOfTimes; }
       set { this.noOfTimes = value; }
   } 
   protected override void Render (HtmlTextWriter writer)
   {
     for (int i=0; i< NoOfTimes; i++)
     {
       write.Write("Hello World.."+"<BR>");
     } 
   }
}

编译自定义控件。

若要使用 Web 窗体页上的自定义控件，请向控件声明中添加新的属性。

 <CC:SimpleServerControl id="ctlSimpleControl" NoOfTimes="5" runat="server"></CC:SimpleServerControl>

运行页将显示自定义控件中的"Hello World"条消息按控件的属性中指定的次数。

如何应用自定义控件上的设计时属性

为什么需要设计时属性

http://msdn2.microsoft.com/en-us/library/Aa288059(VS.71).aspx (http://msdn2.microsoft.com/en-us/library/Aa288059(VS.71).aspx)

让我们生成示例的使用常用属性:

在文本编辑器中打开 SimpleServerControl.cs。

介绍一些基本属性类级别是例如 DefaultProperty 、 ToolboxData 和 TagPrefixAttrbute 。我们将我们的示例基于这三个属性

         [
	// Specify the default property for the control.		
	DefaultProperty("DefaultProperty"),
	
	// Specify the tag that is written to the aspx page when the
        // control is dragged from the Toolbox to the Design view. 
	// However this tag is optional since the designer automatically 
	// generates the default tag if it is not specified.		
	ToolboxData("<{0}:ControlWithAttributes runat=/"server/">" +
		"</{0}:ControlWithAttributes>")
	]
	public class ControlWithAttributes : Control
	{
		private string _defaultProperty;
		public string DefaultProperty
		{
			get { return "This is a default property value"; }
			set { this._defaultProperty = value; }
		}

		protected override void Render(HtmlTextWriter writer)
		{
			writer.Write("Default Property --> <B>" + 
			DefaultProperty + "</B>");
		}
         }

没有名为 TagPrefixAttrbute 的更多标记。它是控件从工具箱拖动到设计器时，提供与标记前缀的程序集级属性。否则，设计器在默认情况下生成一个前缀，如"cc 1"。 TagPrefixAttrbute 不直接应用于控件类。若应用 TagPrefixAttrbute ，请打开 AssemblyInfo.cs 中，包括下行的代码，然后重新生成项目
[assembly:TagPrefix("ServerControlsLib ", "MyControl")]
注释，如果要生成使用该命令行来源需要创建 AssemblyInfo.cs 文件、放置该文件包含所有源文件，在目录中的并运行以下命令以生成该控件：。
> csc /t:library / out: ServerControlsLib.dll /r:System.dll /: System.Web.dll *.cs

回到顶端

用户控件和自定义控件进行基本的区别是什么？

收起该表格展开该表格

因素	用户控件	自定义控件
部署	用于单应用程序方案应用程序的源代码与的一起部署源形式 (.ascx) 如果在同一控件需要在多个应用程序中使用，介绍冗余和维护问题	设计可由多个应用程序部署应用程序的 Bin 目录中或全局程序集缓存中分发轻松且不与冗余和维护相关的问题
创建	创建与 Web 窗体页的创建，适合快速应用程序开发 (RAD) 方式类似	编写涉及大量代码，因为没有任何设计器支持
内容	更多好的选择当您需要固定的布局中的静态内容时，是例如使时页眉和页脚	适合应用程序需要动态的更多要显示的内容；可重复使用的应用程序，是例如的数据与动态行的表格控件绑定
设计	编写不需要多应用程序设计因为它们都是在设计时编写的主要包含静态数据	从零开始编写需要好地理解控件的生命周期和是通常执行负责在用户控件中的顺序在其中事件执行

回到顶端

高级的主题

状态管理

Web 窗体状态管理介绍
http://msdn2.microsoft.com/en-us/library/75x4ha6s(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/75x4ha6s(vs.71).aspx)

ASP.NET 视图状态
http://msdn.microsoft.com/msdnmag/issues/03/02/cuttingedge/default.aspx (http://msdn.microsoft.com/msdnmag/issues/03/02/cuttingedge/default.aspx)

保存 Web 窗体页使用视图状态的值
http://msdn2.microsoft.com/en-us/library/4yfdwycw(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/4yfdwycw(vs.71).aspx)

使用自定义的控件中的视图状态的示例

 using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Web;
using System.Web.SessionState;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;
using System.Text;

namespace ServerControlLib
{
	/// <summary>
	/// When a page framework reloads this control after postback, it   
        /// will restore the values which are in view state.
	/// This control can easily perform state management without 
        /// implementing our own logic for maintaining the state.
	/// </summary>
	public class ViewStateExample : WebControl
	{
		// Text to be displayed in Text box control.
		private string _text;
		
		/*
		 * This property needs to be populated before every 
                 * postback in order to 
		 * retain its value.
		*/ 
		public string Text
		{
			get { return (_text == null) ? "_text property is empty"  : _text; }
			set { _text = value; }
		}

		/*
		 * This property needs to be filled once and should be 
                 * available on the successive postbacks.
		*/ 
		public string TextInViewState
		{
			get
			{
				object o = ViewState["TextInViewState"];
				return (o == null) ? "View state is empty" : (string)o;
			}
			set { ViewState["TextInViewState"] = value; } 
		}

		/*
		 * Over-ridden method on WebControl base class which                   
                 * displays both of the property values 
		 * i.e. one stored in view state and other which is not 
                 * saved in view state.
		*/
		protected override void RenderContents(HtmlTextWriter writer)
		{
			writer.Write("Text Without View State = ");
			writer.Write(Text);
			writer.Write("<hr><br>");
			writer.Write("Text In View State = ");
			writer.Write(TextInViewState);
		}
	}
}

使用上一个 Web 窗体页上的控件的示例

 <%@ Page Language="C#" %>
<%@ Register TagPrefix="CC" Namespace="ServerControlLib" Assembly = "ServerControlLib" %>

<html>
  <head>
    <script runat="server">
      void button1_Click(object sender, EventArgs e)
      {
          Control1.Text = textbox1.Text;
          Control1.TextInViewState = textbox2.Text;
      }
    </script>
  </head>
  <body>
    <form runat="server" ID="Form1">
      <br>
      Property Value Without View State: <asp:TextBox id="textbox1" 
        runat="server" />
      <br>
      Property Value with View State: <asp:TextBox id="textbox2" 
        runat="server" />

      <asp:Button text="Cause Postback" onClick="button1_Click" 
        id="button1" Runat="server" />

      Output from the ViewStateExample Control :
      <CC:ViewStateExample id="Control1" runat="server"/>
    </form>
  </body>
</html>

呈现

呈现 System.Web.UI.Control 类的方法

Control.Render 方法
http://msdn2.microsoft.com/en-us/library/system.web.ui.control.render(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.control.render(vs.71).aspx)

Control.RenderControl 方法
http://msdn2.microsoft.com/en-us/library/system.web.ui.control.rendercontrol(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.control.rendercontrol(vs.71).aspx)

Control.RenderChildren 方法
http://msdn2.microsoft.com/en-us/library/system.web.ui.control.renderchildren(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.control.renderchildren(vs.71).aspx)

如何在页面上呈现控件

 public void RenderControl(HtmlTextWriter writer) 
{
    // Render method on that control will only be called if its visible property is true.
    if (Visible)
    {
        Render(writer);
    }
}

protected virtual void Render(HtmlTextWriter writer) 
{
    RenderChildren(writer);
}
protected virtual void RenderChildren(HtmlTextWriter writer) 
{
    foreach (Control c in Controls) 
    {
        c.RenderControl(writer);
    }
}

如果 (Visible) {Render(writer);}} 保护虚拟 void 呈现 (HtmlTextWriter 编写器） {RenderChildren(writer);} 保护虚拟 void RenderChildren (HtmlTextWriter 编写) {foreach (在控件中控制 c) {c.RenderControl(writer);}}

呈现 System.Web.UI.WebControl 类的方法

WebControl.RenderBeginTag 方法
http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webcontrol.renderbegintag(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webcontrol.renderbegintag(vs.71).aspx)

WebControl.RenderContents 方法
http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webcontrol.rendercontents(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webcontrol.rendercontents(vs.71).aspx)

WebControl.RenderEndTag 方法
http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webcontrol.renderendtag(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/system.web.ui.webcontrols.webcontrol.renderendtag(vs.71).aspx)

WebControl 类的呈现方式会发生

 protected override void Render(HtmlTextWriter writer)
{
    RenderBeginTag(writer);
    RenderContents(writer);
    RenderEndTag(writer);
}

不必重写为 WebControl 类 Render 方法。如果要呈现在 WebControl 类中的内容，您需要重写 RenderContents 方法。但是，如果您仍然想重写 Render 方法，您必须覆盖 RenderBeginTag 方法以及上一代码示例所示的特定顺序 RenderEndTag 方法。

回到顶端

结论

ASP.NET 服务器控件开发基础知识
http://msdn2.microsoft.com/en-us/library/aa310918(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/aa310918(vs.71).aspx)

一个广泛的 Examination of 用户控件
http://msdn2.microsoft.com/en-us/library/ms972975.aspx (http://msdn2.microsoft.com/en-us/library/ms972975.aspx)

生成模板化自定义 ASP.NET 服务器控件
http://msdn2.microsoft.com/en-us/library/Aa478964.aspx (http://msdn2.microsoft.com/en-us/library/Aa478964.aspx)

在 ASP.NET 服务器控件中的事件
http://msdn2.microsoft.com/en-us/library/aa720049(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/aa720049(vs.71).aspx)

与用户控件的复合控件
http://msdn2.microsoft.com/en-us/library/aa719735(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/aa719735(vs.71).aspx)

开发 ASP.NET 服务器控件
http://msdn2.microsoft.com/en-us/library/aa719973(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/aa719973(vs.71).aspx)

开发自定义控件：主要概念
http://msdn2.microsoft.com/en-us/library/aa720226(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/aa720226(vs.71).aspx)

向 ASP.NET 控件添加设计时支持
http://msdn2.microsoft.com/en-us/library/Aa478960.aspx (http://msdn2.microsoft.com/en-us/library/Aa478960.aspx)