一個有趣的問題, 你知道SqlDataAdapter中的Fill是怎麼實現的嗎

一線碼農發表於2020-07-22
SQLLDAAPT

一：背景

1. 講故事

最近因為各方面原因換了一份工作，去了一家主營物聯櫃的公司，有意思的是物聯櫃上的終端是用 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, "<comm.DbDataAdapter.Fill|API> %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["學生表"];

四：總結

本篇就聊這麼多吧，算是解了多年之前我的一個好奇心，希望本篇對您有幫助。

如您有更多問題與我互動，掃描下方進來吧~

圖片名稱

相關文章