SqlDataReader類
可以用SqlDataReader類對象從SQL Server資料庫中讀取行;用OleDbDataReader類對象從支援OLE DB的資料庫中讀行,如Oracle與Access;用OdbcDataReader類對象從支援ODBC的資料庫中讀取行。
DataReader對象允許你以向前的,唯讀方式讀取資料,有時候DataReader對象也稱為消軟管遊標。DataReader對象採用了一種簡化的資料讀取方式,但是提高了效能的同時也犧牲了很多特性。例如在DataSet中支援的排序,分頁等功能。這些功能將在以後的章節進行詳細的介紹。
SqlDataReader的屬性
屬性 |
說明 |
Depth |
其傳回型別為int,取得表示當前行嵌入深度的值 |
FieldCount |
其傳回型別為int,取得當前行的列數 |
IsColsed |
其傳回型別為bool,取得一個布爾值,表示是否關閉資料讀取 |
RecordsAffected |
其傳回型別為int, 取得執行SQL語句增加、修改或刪除的行數。 |
SqlDataReader的方法
方法 |
說明 |
Reader() |
其傳回型別為bool,將資料閱讀器移到結果集的下一行並讀取該行。這個方法返回的布爾值表示結果集中是否有多行 |
GetValue() |
其傳回型別為object, 返回指定列的值 |
GetValues() |
其傳回型別為int,將當前行中所有列的值複製到指定對象數組。這個方法返回的int是數組元素的個數 |
NextResult() |
其傳回型別為bool,將資料閱讀器移到結果集的下一行。這個方法返回的布爾值表示結果集中是否有多行 |
Close() 關閉 |
SqlDataReader 對象 |
GetInt32(),GetChar(), GateDataTime(),Get×××() |
返回指定列的值,並且返回的類型為相應的資料類型。例如GetInt32()返回整型的數值。注意,如果你將傳回值賦予一個類型不符的變數時,將會拋出一個InvalidCastException異常 |
用ExecuteReader()方法執行查詢
下面是一個用ExecuteReader()方法執行SELECT語句的範例。這個方法用DataReader對象返回結果集,然後可以用此對象讀取資料庫返回的行。
範常式序代碼如下:
01 public partial class _Default : System.Web.UI.Page 02 { 03 protected void Page_Load(object sender, EventArgs e) 04 { 05 string connectionString = 06 ConfigurationManager.ConnectionStrings["Northwind"].ConnectionString; 07 SqlConnection con = new SqlConnection(connectionString); 08 string sql = "SELECT top 5 CustomerID,CompanyName,ContactName,Address 09 FROM Customers"; 10 SqlCommand cmd = new SqlCommand(sql, con); 11 con.Open(); 12 SqlDataReader reader = cmd.ExecuteReader(); 13 StringBuilder htmlStr = new StringBuilder(""); 14 while (reader.Read()) 15 { 16 htmlStr.Append("CustomerID:" + reader["CustomerID"] + "<br>"); 17 htmlStr.Append("CompanyName:" + reader["CompanyName"] + "<br>"); 18 htmlStr.Append("ContactName:" + reader.GetString(2) + "<br>"); 19 htmlStr.Append("Address:" + reader.GetString(3) + "<br>"); 20 htmlStr.Append("<hr>"); 21 } 22 reader.Close(); 23 con.Close(); 24 HtmlContent.Text = htmlStr.ToString(); 25 } 26 } |
程式碼說明:在上述文法範例的程式碼中,第5到12行代碼產生所要的對象並執行SELECT語句,從Customers表中讀取前5條記錄。cmd返回的結果集存放在reader對象中,然後你可以用Reader()方法讀取reader對象的記錄。這個方法在有另一個可讀的行時返回布爾真值,否則返回布爾假值。可以從reader對象中讀取一個記錄的各個列值,只要在方括弧中傳入列名即可。如第16和17行所示,我們用reader[“CustomerID”]讀取CustomerID列的各項內容。你也可以直接在方括弧中傳入數字值指定想要列的索引。如第18和19行代碼所顯示,由於我們在用SELECT進行資料查詢的時,ContactName和Address分別位於第3和第4列,而相應的索引值則為2和3,所以我們可以用reader.GetString(2)和reader.GetString(3)讀取ContactName和Address列的資料。如第14行代碼所示,我們可以在While迴圈中用Reader()方法一一讀取每條記錄。
執行結果:
每次程式執行命令時,都要將相應的命令通過網路傳遞到資料庫中,並在資料庫進行執行,然後將結果返回到程式中,從而產生大量的網路通訊流。我們可以使用ExecuteReader()方法同時執行多條SELECT語句查詢減少重複的資料傳遞。
下面的執行個體是使用ExecuteReader()方法同時查詢三個表中的資料,並將返回的三個結果集顯示在頁面上。
範常式序代碼如下:
01 public partial class _Default : System.Web.UI.Page 02 { 03 protected void Page_Load(object sender, EventArgs e) 04 { 05 string connectionString = 06 ConfigurationManager.ConnectionStrings["Northwind"].ConnectionString; 07 SqlConnection con = new SqlConnection(connectionString); 08 SqlCommand cmd = con.CreateCommand(); 09 cmd.CommandText = "SELECT TOP 3 ProductID,ProductName 10 FROM Products ORDER BY ProductID;" + 11 "SELECT TOP 3 CustomerID,CompanyName 12 FROM Customers ORDER BY CustomerID;" + 13 "SELECT TOP 3 OrderID,CustomerID 14 FROM Orders ORDER BY OrderID;"; 15 con.Open(); 16 SqlDataReader reader = cmd.ExecuteReader(); 17 StringBuilder htmStr=new StringBuilder(""); 18 int i = 0; 19 do 20 { 21 htmStr.Append("結果集"); 22 htmStr.Append(i.ToString()); 23 htmStr.Append("<br>"); 24 while (reader.Read()) 25 { 26 htmStr.Append("reader[0]=" + reader[0]); 27 htmStr.Append("<br>"); 28 htmStr.Append("reader[1]=" + reader[1]); 29 htmStr.Append("<br><br>"); 30 } 31 htmStr.Append("<hr>"); 32 i++; 33 } while (reader.NextResult()); 34 reader.Close(); 35 con.Close(); 36 HtmlContent.Text = htmStr.ToString(); 37 } 38 } |
程式碼說明:在上述文法範例的程式碼中,第9行到第14中定義了3個查詢語句,各語句之間用分號進行間隔。第16行調用ExecuteReader()方法,並返回SqlDataReader對象,並且對三條不同的SELECT語句各返回一個結果集。要讀取第一個結果集的話,可以用SqlDataReader對象的Reader()方法。Reader()方法在沒有其他的可讀行時將返回一個false值。當一個結果集的所有記錄都讀取完畢後,可以調用SqlDataReader對象的NextResult()方法,然後在讀取下一個結果集,在沒有其他的結果集時,也返回一個false值。
提示:外迴圈do…while測試結尾的reader. NextResult()的傳回值。由於do…while迴圈末尾檢測這個條件,這樣就保證了do…while迴圈至少執行一次。之所以在末尾才調用NextResult()方法,是因為這樣可以首先把SqlDataReader對象移到下一個結果集,然後才返回表示是否還有下一個結果集的布爾結果。如果使用while迴圈中,則有可能直接跳過第一個結果集,從而產生錯誤。
用ExecuteScalar()方法執行SELECT語句
用ExecuteScalar()方法執行SELECT語句,返回單個值,並且忽略其他的任何讀取的結果。ExecuteScalar()方法返回的結果是一個object對象。ExecuteScalar()主要是用來執行SELECT語句,或者執行包括彙總函式的SQL語句。
下面我們將使用如下的程式讀取Products表中的記錄條數,並且在相應的查詢語句中使用COUNT()彙總函式。
範常式序代碼如下:
01 public partial class _Default : System.Web.UI.Page 02 { 03 protected void Page_Load(object sender, EventArgs e) 04 { 05 string connectionString = 06 ConfigurationManager.ConnectionStrings["Northwind"].ConnectionString; 07 SqlConnection con = new SqlConnection(connectionString); 08 SqlCommand cmd = con.CreateCommand(); 09 cmd.CommandText = "SELECT COUNT(*) FROM Products"; 10 con.Open(); 11 int returnValue = (int)cmd.ExecuteScalar(); 12 HtmlContent.Text = "Products表中共有" + returnValue.ToString()+"條記錄"; 13 } 14 } |
程式碼說明:在上述文法範例的程式碼中,第9行即為查詢Products表中的記錄條數的SQL語句。第11行代碼用ExecuteScalar()方法執行SELECT語句。注意,由於ExecuteScalar()方法的結果為object對象,因此我們要將其進行強制類型轉換,再賦予相應的變數。
執行結果: