一、背景

讲故事

最近因为各方面原因换了一份工作，去了一家主营物联柜的公司，有意思的是物联柜上的终端是用 wpf 写的，代码也算是年久失修，感觉技术债还是蛮重的，前几天在调试一个bug的时候，看到了一段类似这样的代码：

var dt = new DataTable();
    SqlDataAdapter adapter = new SqlDataAdapter(new SqlCommand());
    adapter.Fill(dt);

是不是很眼熟哈，或许你也已经多年不见了，犹记得那时候为了能从数据库获取数据，第一种方法就是采用 SqlDataReader 一行一行从数据库读取，而且还要操心 Reader 的 close 问题，第二种方法为了避免麻烦,就直接使用了本篇说到的 SqlDataAdapter ，简单粗暴，啥也不用操心，对了，不知道您是否和我一样对这个 Fill 方法很好奇呢？，它是如何将数据塞入到 DataTable 中的呢？也是用的 SqlDataReader 吗？而且 Fill 还有好几个扩展方法，哈哈，本篇就逐个聊一聊，就当回顾经典啦！

二、对Fill方法的探究

1. 使用 dnspy 查看Fill源码

dnspy小工具大家可以到GitHub上面去下载一下，这里就不具体说啦，接下来追一下Fill的最上层实现，如下代码：

public int Fill(DataTable dataTable)
        {
            IntPtr intPtr;
            Bid.ScopeEnter(out intPtr, " %d#, dataTable\n", base.ObjectID);
            int result;
            try
            {
                DataTable[] dataTables = new DataTable[]
                {
                    dataTable
                };
                IDbCommand selectCommand = this._IDbDataAdapter.SelectCommand;
                CommandBehavior fillCommandBehavior = this.FillCommandBehavior;
                result = this.Fill(dataTables, 0, 0, selectCommand, fillCommandBehavior);
            }
            finally
            {
                Bid.ScopeLeave(ref intPtr);
            }
            return result;
        }

上面的代码比较关键的一个地方就是 IDbCommand selectCommand = this._IDbDataAdapter.SelectCommand; 这里的 SelectCommand 来自于哪里呢？来自于你 new SqlDataAdapter 的时候塞入的构造函数 SqlCommand，如下代码：

public SqlDataAdapter(SqlCommand selectCommand) : this()
        {
            this.SelectCommand = selectCommand;
        }

然后继续往下看 this.Fill 方法，代码简化后如下：

protected virtual int Fill(DataTable[] dataTables, int startRecord, int maxRecords, IDbCommand command, CommandBehavior behavior)
        {
            result = this.FillInternal(null, dataTables, startRecord, maxRecords, null, command, behavior);

            return result;
        }

上面这段代码没啥好说的，继续往下追踪 this.FillInternal 方法，简化后如下：

private int FillInternal(DataSet dataset, DataTable[] datatables, int startRecord, int maxRecords, string srcTable, IDbCommand command, CommandBehavior behavior)
        {
            int result = 0;
            try
            {
                IDbConnection connection = DbDataAdapter.GetConnection3(this, command, "Fill");
                try
                {
                    IDataReader dataReader = null;
                    try
                    {
                        dataReader = command.ExecuteReader(behavior);
                        result = this.Fill(datatables, dataReader, startRecord, maxRecords);
                    }
                    finally
                    {
                        if (dataReader != null)    dataReader.Dispose();
                    }
                }
                finally
                {
                    DbDataAdapter.QuietClose(connection, originalState);
                }
            }
            finally
            {
                if (flag)
                {
                    command.Transaction = null;
                    command.Connection = null;
                }
            }
            return result;
        }

大家可以仔细研读一下上面的代码，挺有意思的，至少你可以获取以下两点信息：

• 从各个 finally 中可以看到，当数据 fill 到 datatable 中之后，操作数据库的几大对象 Connection,Transaction,DataReader 都会进行关闭，你根本不需要操心。
• this.Fill(datatables, dataReader, startRecord, maxRecords) 中可以看到，底层不出意外也是通过 dataReader.read() 一行一行读取然后塞到 DataTable中去的，不然它拿这个 dataReader 干嘛呢？不信的话可以继续往下追。

protected virtual int Fill(DataTable[] dataTables, IDataReader dataReader, int startRecord, int maxRecords)
        {
            try
            {
                int num = 0;
                bool flag = false;
                DataSet dataSet = dataTables[0].DataSet;
                int num2 = 0;
                while (num2 < dataTables.Length && !dataReader.IsClosed)
                {
                    DataReaderContainer dataReaderContainer = DataReaderContainer.Create(dataReader, this.ReturnProviderSpecificTypes);
                    if (num2 == 0)
                    {
                        bool flag2;
                        do
                        {
                            flag2 = this.FillNextResult(dataReaderContainer);
                        }
                        while (flag2 && dataReaderContainer.FieldCount <= 0);
                        }
                    }
                result = num;
            }
            return result;
        }

从上面代码可以看到， dataReader 被封装到了 DataReaderContainer 中，用 FillNextResult 判断是否还有批语句sql，从而方便生成多个 datatable 对象，最后就是填充 DataTable ，当然就是用 dataReader.Read()啦，不信你可以一直往里面追嘛，如下代码：

private int FillLoadDataRow(SchemaMapping mapping)
        {
            int num = 0;
            DataReaderContainer dataReader = mapping.DataReader;

            while (dataReader.Read())
            {
                mapping.LoadDataRow();
                num++;
            }
            return num;
        }

到这里你应该意识到：DataReader 的性能肯定比 Fill 到 DataTable 要高的太多，所以它和灵活性两者之间看您取舍了哈。

三、Fill 的其他重载方法

刚才给大家介绍的是带有 DataTable 参数的重载，其实除了这个还有另外四种重载方法，如下图：

public override int Fill(DataSet dataSet);
    public int Fill(DataSet dataSet, string srcTable);
    public int Fill(DataSet dataSet, int startRecord, int maxRecords, string srcTable);
    public int Fill(int startRecord, int maxRecords, params DataTable[] dataTables);

1. startRecord 和 maxRecords

从字面意思看就是想从指定的位置 (startRecord) 开始读，然后最多读取 maxRecords 条记录，很好理解，我们知道 reader() 是只读向前的，然后一起看一下源码底层是怎么实现的。

图片

从上图中可以看出，还是很简单的哈，踢掉 startRecord 个 reader(),然后再只读向前获取最多 maxRecords 条记录。

2. dataSet 和 srcTable

这里的 srcTable 是什么意思呢？从 vs 中看是这样的： The name of the source table to use for table mapping. 乍一看也不是特别清楚，没关系，我们直接看源码就好啦，反正我也没测试，嘿嘿。

图片

从上图中你应该明白大概意思就是给你 dataset 中的 datatable 取名字，比如：name= 学生表, 那么database中的的 tablename依次是： 学生表，学生表1，学生表2 ...， 这样你就可以索引获取表的名字了哈，如下代码所示：

DataSet dataSet = new DataSet();
        dataSet.Tables.Add(new DataTable("学生表"));
        var tb = dataSet.Tables["学生表"];

四、总结

本篇就聊这么多吧，算是解了多年之前我的一个好奇心，希望本篇对您有帮助。