Inside ASP.NET 2.0 – Controls Model（转载）

读者基础需求：了解ASP.NET 控件设计技巧參考书目：深入剖析ASP.NET 组件设计(碁峯)、

Developing ASP.NET Server Controls And Components(MS Press)

Controls Model 的变革

如你所知晓，ASP.NET 1.x 提供了设计师丰富且易用的控件群，藉由这些控件，设计师可以快速的建构网页程序，但除了这些表面上看得到的控件外，为了实现组件化设计的理想，ASP.NET 1.x 还提供了简单但完整的Controls Model ，让设计师可以自行撰写控件來增加开发速度，并藉由组件化开发模式來简化程序的复杂度与降低出错率。在ASP.NET 2.0 中，这个Controls Model 做了相当大幅度的延伸，除了相容于原來的Controls Model 外，新的Controls Model 还提供了比以往更加丰富的基础类别。在1.x 时代，老实說控件的开发模式并没有太严谨的规则，设计师只要满足最基础的要求，继承至System.Web.UI.Control 或是System.ComponentModel.Component 就能够撰写控件与组件，虽然这给了设计师高度的自由，但也间接的加重组件设计师的工作量，例如撰写资料感知控件(Data Bound Control)这种很常見的想法，每个设计师硬是得先弄清楚DataSource 与DataField 属性该如何与IDE Designer 互动，然后再撰写特定的ControlDesigner 才能完成这样的控件。为了日后不再重新撰写这些变动率低、又常用到的程序代码，有经验的设计师就会架构自己的一群基础类别。在2.0，这件事不用勞设计师费心了，ASP.NET Team 已经为常用、可制式化的控件建立一群基础类别，现在要建立一个资料感知控件，设计师只要继承至DataBoundControl 即可，不需撰写ControlDesigner 了，要建立复合式控件也只要继承至CompositeControl 就行了，这个设计不但简化了设计师的工作，同时也为控件设计模式定下一个基本的标准，可以让初学者更容易上手，让设计师将时间花费在组件真正的功能上。

Adapter Model

Adapter Model 首次出现于ASP.NET Mobile Controls 中，当时主要的设计概念是为了让ASP.NET 网页能够适用于不同的行动装置，图1 是该设计的概念。图1 Mobile Controls



Adapter Model 采取Adapter 设计模式，将原本应该由Control 负责的Rending 动作交给另一个对象，也就是ControlAdapter 來完成，当要求到达服务器端时，ASP.NET 会判断客户端的装置类别，建立对应的ControlAdapter 來绘制控件，当然！在为了达到Rending 的动作前提下，除了真正的Rending 动作外，ControlAdapter 与Control 还建立了其它的通道，例如不同的Rending 动作需要有不同的Initialize 动作，也可能需要不同的Pre-Rending 动作，因此ControlAdapter 中定义了一群与Control 几乎相同的函式，如Init、PreRender、Render 等等。在ASP.NET 2.0 中，Adapter Model 已经被整合入Control 类别中，现在设计师可以为所有的控件建立ControlAdapter，不再仅限于Mobile Control。这个设计的目的分成远景与近需，近的是为了解决不同浏览器需要使用不同的HTML&JavaScript來绘制控件，远的是为了让Mobile与PC共享一个网页，当然！实务上这是很难达到的。

Base Control Classes

那到底有多少基础类别供我们应用呢？图2 列出目前笔者所观察到的类别。图2 ASP.NET 2.0 的控件基础类别Control 与WebControl 都是组件设计师熟悉的类别，接下來的DataSourceControl 是ASP.NET 2.0 新引入的Data-Binding 技术所用的基础类别，在2.0 中，DataSet 已经被SqlDataSource、AccessDataSource、OracleDataSource 等DataSource Control 所取代，而她们的基础类别就是DataSourceControl。BaseDataBoundControl 就是先前所提及的资料感知控件的基础类别，她提供了预定义的DataSourceID 属性，并为设计师预先建构了专属的ControlDesigner，因此只要继承至此类别，设计师只需专心撰写控件的程序代码，不须再耗费时间处理IDE 的相关细节。DataBoundControl 是更具体化些的基础类别，除了原有的DataSourceID 之外，另外还提供了DataMember 属性，她应该是最常用的资料感知控件基础类别，其子嗣CompositeDataBoundControl 则是用于复合式资料感知组件，如DetailsView、FormView及GridView的基础类别都是源自于此，HierarchicalDataBoundControl 是另一个支线，她是TreeView、Menu 的基础类别。最后一个基础类别是CompositeControl，用于撰写简单、不含资料感知能力的复合式控件。

Base Control Designer Classes

基础类别除了提供一致的实作标准外，更好的是她们预先配备了标准的ControlDesigner 來处理IDE 细节，图3 是这些基础类别所配备的基础ControlDesigner 。。图3 ASP.NET 2.0 的控件基础ControlDesigner 读者们应该可以由名称來对应出那个基础类别所用的ControlDesigner。



Designer Actions

初用VWD 或VS.NET 2005 的设计师应该都对其新的设计接口感到方便或是累赘，不管是那种感觉，至少新的设计模式真的让我们减少在WebForm 与属性盘上來回的次数， 如4 是这个新花招的截图。图4 ASP.NET 2.0 的新界面



Microsoft 将此技术称为Smart Task(Smart Tag 之毒？)，简单的說就是将常用的属性与工作放到这个容器中，让设计者可以方便的设定她们，不须在属性表及WebForm 上來來去去，当然！这也有缺点，这个窗口显示的速度考验着开发者的计算机速度，何时该缩、何时该展开也考验着接口设计人员的智能。那如何让自己的控件拥有这种效果呢？說來也简单，見程序1。 程序1 建立含有Smart Task 的控件

#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
using System.Web.UI.WebControls;
using System.ComponentModel;

using System.ComponentModel.Design;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
#endregion

namespace ClassLibrary1{
public class SCCDesignerActionList : DesignerActionList {
private ControlDesigner _designer;
public bool ShowText {
get { return ((SimpleDesignerTest)_designer.Component).ShowText; }
set { ((SimpleDesignerTest)_designer.Component).ShowText = value; _designer.UpdateDesignTimeHtml();}
}
public SCCDesignerActionList(ControlDesigner designer):base() {
_designer = designer;
}
public void FireShowText() {
ShowText = true;
}
public void FireHideText() {
ShowText = false;
}
public override DesignerActionItem[] GetSortedActionItems() {
DesignerActionPropertyItem item = new DesignerActionPropertyItem("ShowText", "Show Text","Appearence");
DesignerActionMethodItem m_item;
if (!ShowText)
m_item = new DesignerActionMethodItem(this, "FireShowText", "Show Text","Actions");
else
m_item = new DesignerActionMethodItem(this, "FireHideText", "Hide Text", "Actions");
return new DesignerActionItem[] {item,m_item};
}
}

public class SCCControlDesigner : System.Web.UI.Design.ControlDesigner {
public SCCControlDesigner() : base() { }
public override DesignerActionListCollection ActionLists {
get
{
DesignerActionListCollection actions = new DesignerActionListCollection();
actions.AddRange(base.ActionLists);
actions.Add(new SCCDesignerActionList(this));
return actions;
}

}
}
[DesignerAttribute(typeof(SCCControlDesigner), typeof(IDesigner))]
public class SimpleDesignerTest:WebControl {
public bool ShowText {
get {
object o = ViewState["ShowText"];if (o != null)
return (bool)o;
return true;
}
set {ViewState["ShowText"] = value; }
}
protected override void Render(System.Web.UI.HtmlTextWriter writer) {
if(ShowText)
writer.WriteLine("TEST"); }
public SimpleDesignerTest() { }
}
}

DesignerActionPropertyItem 指的是一个属性型态的Smart Tas k，IDE 会将指定的属性显示成Smart Task，并套用该属性所有的属性编辑器。DesignerActionMethodItem 指的是一

个选项，供使用者点选后执行某些动作，与以前的DesignerVerbs 功能相同。

New Data Binding System

对于ASP.NET 的使用者而言，新的Data Binding 系统无疑是2.0 中变动最大、影响也最深的设计，原來的DataSet 已经被DataSource Control 所取代，这个变动将ASP.NET 的RAD 设计模式推进一大步，DataSource 模式讲求将资料操作完全封装在DataSource Control 中，控件与其的连结仅止与资料的交换，设计师也不再需要烦恼分页、快取等琐碎的问题，甚至可以使用ObjectDataSource 來建构分布式系统。对于组件设计师來說， 新的Data Binding 模式影响不大，因为2.0 已经建构了完整的基础类别，程序2 是一个简单的Table 控件(因为Beta 1 将DataBoundControlDesigner 标示为抽象类别，因此我们得继承她才能使用)。

程序2 SimpleTable 控件

#region Using directives
using System;
using System.Collections;
using System.Collections.Generic;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;
using System.ComponentModel;
using System.Web.UI.Design.WebControls;
#endregion

namespace ClassLibrary1 {

public class SimpleTableDesigner : DataBoundControlDesigner { }
[Designer(typeof(SimpleTableDesigner))]
public class SimpleTable:DataBoundControl {
private IEnumerable _dataRecs;
protected override HtmlTextWriterTag TagKey {
get { return HtmlTextWriterTag.Table; }
}
protected virtual void RenderHeader() {

if (_dataRecs != null) {
foreach (object item in _dataRecs)
{
HtmlTableRow row = new HtmlTableRow();
foreach (PropertyDescriptor prop in TypeDescriptor.GetProperties(item))
{
HtmlTableCell col = new HtmlTableCell();
col.Controls.Add(new LiteralControl(prop.Name));
row.Controls.Add(col);
}
Controls.Add(row);
break;
}
}
}

protected virtual void RenderRows()
{ if (_dataRecs != null)
{
foreach (object item in _dataRecs)
{ HtmlTableRow row = new HtmlTableRow();
foreach (PropertyDescriptor prop in TypeDescriptor.GetProperties(item))
{ HtmlTableCell col = new HtmlTableCell();
object v = prop.GetValue(item);
if (v != null) col.Controls.Add(new LiteralControl(v.ToString()));
row.Controls.Add(col); }
Controls.Add(row); } }
}

private void OnSelectCallBack(IEnumerable data) {
_dataRecs = data;
}
protected void RetrieveData() {
DataSourceView view = GetData();
if(view != null)
view.Select(DataSourceSelectArguments.Empty, new DataSourceViewSelectCallback(OnSelectCallBack));
}

public override void DataBind() {
ClearChildControlState(); Controls.Clear();
RetrieveData();
RenderHeader();
RenderRows();
ChildControlsCreated = true;
TrackViewState();
}

protected override void OnPreRender(EventArgs e) {
if (_dataRecs == null)
DataBind();
base.OnPreRender(e);
}

public SimpleTable() { }

} }

Non Visual Controls

ASP.NET 2.0 取消了Component Tray ，这代表着Component 在ASP.NET 2.0 中将完全失去RAD 能力，取而代之的是类似DataSource Control 类的非可视型组件，就实务上來說，Non Visual Control 还是一个控件，差别在于IDE 如何看待她，要将某个控件标示为Non Visual Control ，只要配上NonVisualControl Attribute 即可。

[NonVisualControl(true)]

截至目前为止，我仍未发现该Attribute 会对IDE 造成何种影响，或许日后正式版时该Attribute 会用于另一种设计，让Non Visual Control 不会影响到设计版面。

Web Parts

2.0 将原本于SharePoint 上的Web Parts 整合进來，许多初次接触Web Parts 的朋友反应都很正面，这个技术可以让我们与组件化设计模式更贴近，在组件设计上，撰写一个自订的Web Parts 也很容易，程序3 是个简单的范例，她也同时展示了如何使用Web Parts 的Connection 技术。程序3

#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
using System.Security.Permissions;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.ComponentModel;
#endregion

namespace ClassLibrary1{
public class MySimpleWebPart:WebPart
{
public override bool AllowEdit
{
get { return true; }
set {base.AllowEdit = value; }
}
public string Text { get { object o = ViewState["Text"];
if (o != null) return (string)o;
return String.Empty; }
set { ViewState["Text"] = value; }
}
[WebBrowsable,Personalizable(PersonalizationScope.User)]
public string TestVeriable { get { return "TEST"; }
set { ;}
}

[WebBrowsable,Personalizable,Category("Behavior")]
public string TestVeriable2 { get { return "TEST"; }
set { ;}
}
[ConnectionProvider("provider","provider")]
public object GetData() {
return Text;
}

[ConnectionConsumer("consumer","consumer")]
public void SetData(object data) {
Text = (string)data;
}
protected override void RenderContents(HtmlTextWriter writer) {
writer.WriteLine(Text);
}
public MySimpleWebPart() { }
}
}

Client Callback

ASP.NET 的PostBack 技术使网页程序的功能更贴近窗口程序，但仍然无法避免于PostBack 发生时画面的闪烁情况，其实这个问题一直都困扰着许多的设计师，为了让网页能在最小闪烁情况下更新，XMLHTTP 技术就应运而生，此技术运用了XML 与HTTP协议，再整合JavaScript 让网页可以在某个事件发生时更新一部份的网页，由于并非是重新向Web Server 要求网页，因此画面的闪烁情况可以减到最轻。2.0 整合了此技术，提供了一个标准的JavaScript 及ICallbackEventHandler 接口，控件只要实作此接口，并搭配上适当的JavaScript ，就能达到网页部份刷新的效果，程序10是一个简单的范例，LowcaseTextBox会将所有输入的字串转成小写，读者可以放上她及几个RadioButton或是CheckBox，当焦点由LowcaseTextBox 離开时，就可发现字串都被转成小写，你也会发现，浏览器并未重新刷新网页，也没有闪烁的情况。程序10 LowcaseTextBox

#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
using System.ComponentModel;
using System.Web.UI;
using System.Web.UI.WebControls;
#endregion
namespace ClassLibrary1{

public class LowcaseTextBox:TextBox,ICallbackEventHandler {

private const string SCRIPT =

"<script language='JavaScript'>/n"+

"function SetText(eventarg){/n"+

"document.getElementById('%ID%').value = eventarg;/n"+

"}</script>";

public LowcaseTextBox() { }
protected override void AddAttributesToRender(
HtmlTextWriter writer) {
base.AddAttributesToRender(writer);
writer.AddAttribute(

HtmlTextWriterAttribute.Onchange, Page.GetCallbackEventReference(

this,ClientID+".value","SetText",null)); }
protected override void OnPreRender(EventArgs e) {

base.OnPreRender(e);
Page.ClientScript.RegisterClientScriptBlock( GetType(), ClientID,
SCRIPT.Replace("%ID%",ClientID));
}
#region ICallbackEventHandler Members
public string RaiseCallbackEvent(string eventArgument) {

return eventArgument.ToLower(); }

#endregion

} }

Still Running

ASP.NET 2.0 仍在开发中，可以预期的是Web Parts 部份会持续的加强，许多更方便的基础类别也会一一的加入，相信在2.0 推出后，在控件市场上一定会出现相当多且方便的控件。