一个相当独立的.通用分页控件c#源码三(downmoon收集)

DataView类型和DataTable类型的关系是如此密切，所以构造一个通用性的DataAdapter可能是有意义的，其实只要加入另一个处 理DataTable的构造函数就足够了。遗憾的是，当用户需要不同的功能来处理某个DataTable时，就必须替换或继承整个类。如果我们构造一个使 用同一IdataSourceAdapter的新Builder，用户在选择如何实现适配器时就拥有更多的自由。

在分页控件中，寻找适当Builder类的操作由一个类型安全的集合完成。

public   class  AdapterCollection:DictionaryBase
... {
private string GetKey(Type key)
...{
return key.FullName;
}
public AdapterCollection() ...{}
publicvoid Add(Type key,AdapterBuilder value)
...{
Dictionary.Add(GetKey(key),value);
}
publicbool Contains(Type key)
...{
return Dictionary.Contains(GetKey(key));
}
publicvoid Remove(Type key)
...{
Dictionary.Remove(GetKey(key));
}
public AdapterBuilder this[Type key]
...{
get...{return (AdapterBuilder)Dictionary[GetKey(key)];}
set...{Dictionary[GetKey(key)]=value;}
}
}

AdapterCollection依赖于DataSource类型，DataSource通过BoundControl_DataBound巧妙地引 入。这里使用的索引键是Type.FullName方法，确保了每一种类型索引键的唯一性，同时这也把保证每一种类型只有一个Builder的责任赋予了 AdapterCollection。将Builder查找加入BoundControl_DataBound方法，结果如下：

public  AdapterCollection Adapters
... {
get...{return _adapters;}
}

private   bool  HasParentControlCalledDataBinding
... {
get...{return _builder != null;}
}

private   void  BoundControl_DataBound( object  sender,System.EventArgs e)
... {
if (HasParentControlCalledDataBinding) return;
Type type = sender.GetType();
_datasource = type.GetProperty("DataSource");
if (_datasource == null)
throw new NotSupportedException("分页控件要求表现控件必需包含一个DataSource。");
object data = _datasource.GetGetMethod().Invoke(sender,null);
_builder = Adapters[data.GetType()];
if (_builder == null)
throw new NullReferenceException("没有安装适当的适配器来处理下面的数据源类型："+data.GetType());
_builder.Source = data;

ApplyDataSensitivityRules();
BindParent();
RaiseEvent(DataUpdate,this);
}  

BoundControl_DataBound方法利用HasParentControlCalledDataBinding检查是否已经创建了Builder，如果是，则不再执行寻找适当Builder的操作。Adapters表的初始化在构造函数中完成：

public  Pager()
... {
SelectedPager=new System.Web.UI.WebControls.Style();
UnselectedPager = new System.Web.UI.WebControls.Style();
_adapters = new AdapterCollection();
_adapters.Add(typeof(DataTable),new DataTableAdapterBuilder());
_adapters.Add(typeof(DataView),new DataViewAdapterBuilder());
}  

最后一个要实现的方法是BindParent，用来处理和返回数据。

private   void  BindParent()
... {
_datasource.GetSetMethod().Invoke(BoundControl,
new object[]...{_builder.Adapter.GetPagedData(StartRow,ResultsToShow*CurrentPage)});
}

这个方法很简单，因为数据处理实际上是由Adapter完成的。这一过程结束后，我们还要用一次Reflection API，不过这一次是设置表现控件的DataSource属性。 　　三、界面设计

至此为止，分页控件的核心功能已经差不多实现，不过如果缺少适当的表现方式，分页控件不会很有用。

为了有效地将表现方式与程序逻辑分离，最好的办法莫过于使用模板，或者说得更具体一点，使用Itemplate接口。实际上，微软清楚地了解模板的强大 功能，几乎每一个地方都用到了模板，甚至页面解析器本身也不例外。遗憾的是，模板并不象有些人认为的那样是一个简单的概念，需要花些时间才能真正掌握它的 精髓，好在这方面的资料比较多，所以这里就不再赘述了。返回来看分页控件，它有四个按钮：首页，前一页，后一页，末页，当然另外还有各个页面的编号。四个 导航按钮选自ImageButton类，而不是LinkButton类，从专业的Web设计角度来看，图形按钮显然要比单调的链接更有用一些。

public  ImageButton FirstButton ... {get ...{return First;}}
public  ImageButton LastButton ... {get ...{return Last;}}
public  ImageButton PreviousButton ... {get ...{return Previous;}}
public  ImageButton NextButton ... {get ...{return Next;}}  

页面编号是动态构造的，这是因为它们依赖于数据源中记录数量的多少、每个页面显示的记录数量。页面编号将加入到一个Panel，Web设计者可以通过 Panel来指定要在哪里显示页面编号。有关创建页面编号的过程稍后再详细讨论，现在我们需要为分页控件提供一个模板，使得用户能够定制分页控件的外观。

[Template Container( typeof (LayoutContainer))]
public  ITemplate Layout
... {
get...{return (_layout;}
set...{_layout =value;}
}

public   class  LayoutContainer:Control,INamingContainer
... {
public LayoutContainer()
...{this.ID = "Page";}
}  

LayoutContainer类为模板提供了一个容器。一般而言，在模板容器中加入一个定制ID总是不会错的，它将避免处理事件和进行页面调用时出现的问题。下面的UML图描述了分页控件的表现机制。






创建模板的第一步是在aspx页面中定义布局：

＜LAYOUT＞
＜asp:ImageButton id = " First "  Runat = " server "  imageUrl = " play2L_dis.gif "
AlternateText = " 首页 " ＞＜ / asp:ImageButton＞
＜asp:ImageButton id = " Previous "  Runat = " server "  imageUrl = " play2L.gif "
AlternateText = " 上一页 " ＞＜ / asp:ImageButton＞
＜asp:ImageButton id = " Next "  Runat = " server "  imageUrl = " play2.gif "
AlternateText = " 下一页 " ＞＜ / asp:ImageButton＞
＜asp:ImageButton id = " Last "  Runat = " server "  imageUrl = " play2_dis.gif "
AlternateText = " 末页 " ＞＜ / asp:ImageButton＞
＜asp:Panel id = " Pager "  Runat = " server " ＞＜ / asp:Panel＞
＜ / LAYOUT＞

这个布局例子不包含任何格式元素，例如表格等，实际应用当然可以（而且应该）加入格式元素，请参见稍后的更多说明。

Itemplate接口只提供了一个方法InstantiateIn，它解析模板并绑定容器。

private   void  InstantiateTemplate()
... {
_container = new LayoutContainer();
Layout.InstantiateIn(_container);
First = (ImageButton)_container.FindControl("First");
Previous = (ImageButton)_container.FindControl("Previous");
Next = (ImageButton)_container.FindControl("Next");
Last = (ImageButton)_container.FindControl("Last");
Holder = (Panel)_container.FindControl("Pager");
this.First.Click += new System.Web.UI.ImageClickEventHandler(this.First_Click);
this.Last.Click += new System.Web.UI.ImageClickEventHandler(this.Last_Click);
this.Next.Click += new System.Web.UI.ImageClickEventHandler(this.Next_Click);
this.Previous.Click += new System.Web.UI.ImageClickEventHandler(this.Previous_Click);
}

控件的InstatiateTemplate方法要做的第一件事情是实例化模板，即调用Layout.InstantiateIn (_container)。容器其实也是一种控件，用法也和其他控件相似。InstantiateTemplate方法利用这一特点寻找四个导航按钮，以 及用来容纳页面编号的Panel。导航按钮通过它们的ID找到，这是对分页控件的一点小小的限制：导航按钮必须有规定的ID，分别是First、 Previous、Next、Last，另外，Panel的ID必须是Pager，否则就会找不到。遗憾的是，就我们选定的表现机制而言，这似乎是较好的 处理方式了；但可以相信的是，只要提供适当的说明文档，这一小小限制不会带来什么问题。另外一种可选择使用的办法是：让每一个按钮从 ImageButton类继承，从而也就定义了一个新的类型；由于每一个按钮是一种不同的类型，在容器中可以实现一个递归搜索来寻找各种特定的按钮，从而 不必再用到按钮的ID属性。

找到四个按钮之后，再把适当的事件句柄绑定到这些按钮。在这里必须做一个重要的决定，即何时调用 InstantiateTemplate。一般地，这类方法应当在CreateChildControls方法中调用，因为 CreateChildControls方法的主要用途就是这一类创建子控件的任务。由于分页控件永远不会修改其子控件，所以它不需要 CreateChildControls提供的功能来根据某些事件修改显示状态。显示子控件的速度总是越快越好，因此调用 InstantiateTemplate方法的比较理想的位置是在OnInit事件中。

protected   override   void  OnInit(EventArgs e)
... {
_boundcontrol = Parent.FindControl(BindToControl);
BoundControl.DataBinding += new EventHandler(BoundControl_DataBound);
InstantiateTemplate();
Controls.Add(_container);
base.OnInit();
}

OnInit方法除了调用InstantiateTemplate方法，它的另一个重要任务是将容器加入分页控件。如果不将容器加入到分页器的控件集合，由于Render方法永远不会被调用，所以模板就不可能显示出来。

模板还可以用编程的方式通过实现Itemplate接口定义，这一特性除了可作为提高灵活性的措施之外，还可以提供一个默认的模板，以便在用户没有通过aspx页面提供模板时使用。