二、核心功能
当表现控件触发DataBinding事件,分页控件就可以获取DataSource属性。遗憾的是,微软没有提供所 有数据绑定类实现的接口,诸如IdataSourceProvider之类,而且并非所有从Control或WebControl类继承的控件都有一个 DataSource属性,因此向上定型成Control类没有意义,唯一可行的办法是通过Reflection API直接操作DataSoruce属性。在讨论事件句柄方法之前,应该指出的是,为了注册事件句柄,首先必须获得一个表现控件的引用。分页控件显露了一 个简单的字符串属性BindToControl:
public string BindToControl
...{
get
...{
if (_bindcontrol == null)
throw new NullReferenceException("在使用分页控件之前,请先通过设置BindToControl属性绑定到一个控件。");
return _bindcontrol;}
set...{_bindcontrol=value;}
}
这个方法非常重要,所以最好能够抛出一个含义更明确的信息,而不是抛出标准的NullReferenceException异常。在分页控件的 OnInit方法中,我们解析了对表现控件的引用。本例应当用OnInit事件句柄(而不是构造函数)来确保JIT编译的aspx页面已经设置了 BindToControl。
protected override void OnInit(EventArgs e)
...{
_boundcontrol = Parent.FindControl(BindToControl);
BoundControl.DataBinding += new EventHandler(BoundControl_DataBound);
base.OnInit(E);
...
}
搜索表现控件的操作通过搜索分页控件的Parent控件完成,在这里,Parent就是页面本身。按照这种方式使用Parent比较危险,举例来说,如 果分页控件嵌入到了另一个控件之中,例如嵌入到了Table控件之中,则Parent引用实际上将是一个对Table控件的引用。由于 FindControl方法只搜索当前的控件集合,除非表现控件就在该集合之中,否则不可能搜索到。一种比较安全的方法是递归地搜索各个控件集合,直至找 到目标控件为止。
找到BoundControl之后,我们将分页控件注册成为DataBinding事件的监听器。由于分页控件要操作数 据源,所以该事件句柄应当是调用链中的最后一个,这一点很重要。不过,只要表现控件在OnInit事件句柄中注册DataBinding的事件句柄(默认 行为),分页控件操作数据源时就不会出现问题。
DataBound事件句柄负责获取表现控件的DataSource属性。
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);
}
在DataBound中,我们尝试通过Reflection API获得DataSource属性,然后返回实际数据源的一个引用。现在虽然已经获知了数据源,但分页控件还必须知道如何操作该数据源。为了让分页控件 不依赖于特定的表现控件,问题复杂了很多。不过,如果让分页控件依赖于特定的数据源,那就背离了设计一个灵活的分页控件的目标。我们要通过一个接插式的体 系结构来确保分页控件能够处理各种数据源,无论是.NET提供的数据源,还是自定义的数据源。
为了提供一个健壮的、可伸缩的接插式体系结构,我们将利用[GoF] Builder模式构造出一个解决方案。
IDataSourceAdapter接口定义了分页控件操作数据所需的最基本的元素,相当于“插头”。
publicinterface IDataSourceAdapter
...{
int TotalCount...{get;}
object GetPagedData(int start,int end);
}
TotalCount属性返回在处理数据之前数据源所包含元素的总数,而GetPagedData方法返回原始数据的一个子集,例如:假设数据源是一个 包含20个元素的数组,分页控件将数据显示成每页10个元素,则第一页的元素子集是数组元素0-9,第二页的元素子集是数组元素10-19。 DataViewAdapter提供了一个DataView类型的插头:
internal class DataViewAdapter:IDataSourceAdapter
...{
private DataView _view;
internal DataViewAdapter(DataView view)
...{
_view = view;
}
public int TotalCount
...{
get...{return (_view == null) ? 0 : _view.Table.Rows.Count;}
}
public object GetPagedData(int start, int end)
...{
DataTable table = _view.Table.Clone();
for (int i = start;i<=end && i<= TotalCount;i++)
...{
table.ImportRow(_view[i-1].Row);
}
return table;
}
}
DataViewAdapter实现了IDataSourceAdapter的GetPagedData方法,该GetPagedData克隆原始的 DataTable,将原始DataTable中的数据导入到新的DataTable。该类的可见性有意地设置成internal,目的是为了向Web开 发者隐藏实现细节,进而通过Builder类提供一个更简单的接口。
public abstract class AdapterBuilder
...{
private object _source;
private void CheckForNull()
...{
if (_source == null) throw new NullReferenceException("必须提供一个合法的数据源");
}
public virtual object Source
...{
get
...{
CheckForNull();
return _source;}
set
...{
_source = value;
CheckForNull();
}
}
public abstract IDataSourceAdapter Adapter...{get;}
}
AdapterBuilder抽象类为IdataSourceAdapter类型提供了一个更容易管理的接口,由于提高了抽象程度,我们不必再直接使用 IdataSourceAdapter,同时AdapterBuilder还提供了在分页数据之前执行预处理的指令。另外,该Builder还使得实际的 实现类,例如DataViewAdapter,对分页控件的用户透明:
public class DataTableAdapterBuilder:AdapterBuilder
...{
private DataViewAdapter _adapter;
private DataViewAdapter ViewAdapter
...{
get
...{
if (_adapter == null)
...{
DataTable table = (DataTable)S