自訂伺服器控件時,需繼承下列三個類別之一:Control、WebControl、CompositeControl。本文先從整体上剖析它們的呈現(Render)流程。
Control 類別定義為實作 IComponent、IDisposable、IParserAccessor 等多個介面。其核心在於 Render 方法:
protected internal virtual void Render(HtmlTextWriter writer) 會呼叫 RenderChildren(writer);而 RenderChildren 再進一步呼叫 RenderChildrenInternal。
一般流程與 ASP.Net AJAX 1.0 的分歧點,正出在 RenderChildrenInternal 這個方法上:
internal void RenderChildrenInternal(HtmlTextWriter writer, ICollection children)
{
//是 ASP.Net AJAX 處理
if ((this.RareFields != null) && (this.RareFields.RenderMethod != null))
{
writer.BeginRender();
this.RareFields.RenderMethod(writer, this);
writer.EndRender();
}
else if (children != null)
{
//不是 ASP.Net AJAX 處理,將執行 foreach 依序遍歷所有子控件
foreach (Control control in children)
{
control.RenderControl(writer);//完成子控件的呈現過程
}
}
}
接著是 RenderControl 與 RenderControlInternal:RenderControl 會判斷是否啟用追蹤(Trace),若啟用則記錄每個控件的緩衝大小,最終都會走到 RenderControlInternal。而 RenderControlInternal 的關鍵在於:若存在 ControlAdapter,就交由 adapter 的 BeginRender、Render、EndRender 處理;否則直接呼叫 this.Render(writer)。
WebControl 繼承自 Control 並實作 IAttributeAccessor。開發時有三個重點方法:
CompositeControl 是一個抽象類別,繼承自 WebControl,並實作 INamingContainer 與 ICompositeControlDesignerAccessor。有沒三個不得不提的方法: