现在的位置: 首页 > 综合 > 正文

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

2013年10月18日 ⁄ 综合 ⁄ 共 5771字 ⁄ 字号 评论关闭

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页面提供模板时使用。

抱歉!评论已关闭.