asp.net控件开发基础(23)

         示例代码
本篇随笔2个月前就已经写了一些,今天把以前写的东西删了,只挑重要的讲.东西牵涉的比较多,就给耽搁了.今天继续.

          上一篇讨论了如何实现一个简单的数据源控件,但还没有完全的实现.这次我们具体的实现一些方法来加强数据源控件的功能.这里我们根据SqlDataSource控件的一些功能来实现.

本篇示例源码来自Professional ASP.NET2.0 ServerControl and Component Development,即是模仿SqlDataSource而制作.我把控件功能减弱,代码整理了下,我们只关注重要的部分,一步一步上去.

一.概念

1.首先你必须熟悉ADO.NET的使用,然后抽象出一部分属性和方法,如执行sql语句命令类型,这个属性你便可以抽象出来,当是控件功能的一部分.所以这部分代码不再列出,大家仔细看就会明白了.

2.数据操作注意事项

(1)数据前后操作事件,我们见过SqlDataSource的数据前后操作事件,如读取数据,前后事件则是Selecting和Selected

假设getData方法是读取数据库,那么写成代码就是这样

      protected override IEnumerable ExecuteSelect(DataSourceSelectArguments arguments)
      {
          SqlDataSourceSelectingEventArgs e = new SqlDataSourceSelectingEventArgs(com, arguments);
          //尝试数据检索操作前引发 Selecting 事件
          OnSelecting(e);
          return getData();
          SqlDataSourceStatusEventArgs ee = new SqlDataSourceStatusEventArgs(com, -1, null);
          //尝试数据检索操作后引发 Selecting 事件
          OnSelected(ee);
      }

其他数据操作也一样

(2)自动重新绑定

读取数据是基本的,不存在对数据库的更改,当对数据进行增,删,改时.数据发生了变化,以前我们则是手动进行重新绑定,现在也是,只不过方式变了而已.DataSourceView中存在OnDataSourceViewChanged 方法,我们只需要调用这个方法引发DataSourceViewChanged事件通知数据发生了变化,就会帮你自动重新绑定了,即除了读取数据以外的其他数据操作都需要调用这个方法.假设是删除操作,则代码如下

      protected override int ExecuteDelete(IDictionary keys, IDictionary oldValues)
      {
          SqlDataSourceCommandEventArgs e = new SqlDataSourceCommandEventArgs(com);
          OnDeleting(e);
          affectedRows = com.ExecuteNonQuery();
          OnDataSourceViewChanged(EventArgs.Empty);
          SqlDataSourceStatusEventArgs ee = new SqlDataSourceStatusEventArgs(com, affectedRows, exception);
          OnDeleted(ee);
          return affectedRows;
      }

(3)Can属性

指定能否进行数据操作,读取数据默认可以,其他的操作可以在方法开始部分加上如下代码,假设是不支持删除操作

      protected override int ExecuteDelete(IDictionary keys, IDictionary oldValues)
      {
          if (!CanDelete)
              throw new NotSupportedException("不支持删除操作");
      }

(4)数据检索额外操作

数据源控件还可以提供额外的数据操作,如排序,分页等.
DataSouceView的ExecuteSelect方法里的参数正是DataSourceSelectArguments类型,可以通过其AddSupportedCapabilities方法添加功能,然后调用RaiseUnsupportedCapabilitiesError方法检测操作要求与实现是否符合(即你指定了排序的功能,但数据源控件并未实现这个操作,防止弄虚做假的事情出现,核对一下功能:))
当然前提是数据源提供这样的功能实现,注意DataSourceSelectArguments类的属性与支持功能相对应,大家可以查看MSDN,代码如下

     protected override IEnumerable ExecuteSelect(DataSourceSelectArguments arguments)
      {
          arguments.AddSupportedCapabilities(DataSourceCapabilities.Page);
          arguments.AddSupportedCapabilities(DataSourceCapabilities.Sort);
          arguments.RaiseUnsupportedCapabilitiesError(this);
      }

接着还要重写DataSourceView的RaiseUnsupportedCapabilityError方法

      protected override void RaiseUnsupportedCapabilityError(DataSourceCapabilities capability)
      {
          if ((((capability & DataSourceCapabilities.Page) != 0) && !CanPage) ||
              (((capability & DataSourceCapabilities.RetrieveTotalRowCount) != 0) && !CanRetrieveTotalRowCount) ||
              (((capability & DataSourceCapabilities.Sort) != 0) && !CanSort))
              throw new NotSupportedException();

          base.RaiseUnsupportedCapabilityError(capability);
      }

(5)执行数据操作(同步与异步)
ExecuteInsert等方法为具体实现
Insert方法则负责调用,其DataSourceView类支持数据的异步操作,如

public virtual void Insert (
    IDictionary values,
    DataSourceViewOperationCallback callback
)

但默认情况下是同步的,所以还需要在子类实现一个同步的方法

      public int Insert(IDictionary values)
      {
          return ExecuteInsert(values);
      }

以上是我认为值得注意的地方.
DataSourceView类就是一个干活的类.反而DataSourceControl差不多什么也没做,只调用DataSourceView的相关方法.其只为DataSourceView类提供了ConnectionString属性(数据连接字符串).
DataSourceControl实现了IDataSource接口,当数据源发生变化时,则需要调用IDataSource接口的DataSourceChanged事件,DataSourceControl提供了RaiseDataSourceChangedEvent方法调用,如修改了ConnectionString属性就需要调用此方法,如

public virtual string ConnectionString
{
    get
    {
        if (this._connectionString != null)
        {
            return this._connectionString;
        }
        return string.Empty;
    }
    set
    {
        if (this.ConnectionString != value)
        {
            this._connectionString = value;
            this.RaiseDataSourceChangedEvent(EventArgs.Empty);
        }
    }
}

以上为我学习方法的总结,都是比较重要的地方.
如果列代码的话,不适合.因为大家数据库操作本来就会的.
熟悉上面的操作过程然后再进行编写就好多了.
还希望与大家多交流,错误的地方还请指出.