Command對象主要用來運(yùn)行SELECT、INSERT、UPDATE或DELETE之類的SQL語句。Command對象還可以調(diào)用存儲(chǔ)過程或從特定表中取得記錄。
DataReader對象主要是用來讀取數(shù)據(jù)結(jié)果,使用它讀取記錄時(shí)通常比從DataSet更快。DataReader類有三種:SqlDataReader、OleDbDataReader和OdbcDataReader。DataReader對象用Commmand對象從數(shù)據(jù)庫中讀取記錄,并且DataReader對象只能向前的讀取記錄,用于在某些情況下替代DataSet對象(DataSet對象可以存儲(chǔ)數(shù)據(jù)庫中的行拷貝,可以在切斷數(shù)據(jù)庫的連接時(shí)處理這個(gè)拷貝,我們將在以后的章節(jié)中詳細(xì)介紹該對象)。
注意:不能用DataReader修改數(shù)據(jù)庫中的記錄,它是采用向前的,只讀的方式讀取數(shù)據(jù)庫。
SqlCommand類
SqlCommand對象用于對Sql Server數(shù)據(jù)庫執(zhí)行命令。OleDbCommand對象用于對支持OleDb的數(shù)據(jù)庫執(zhí)行命令,如Oracle與Access。OdbcCommand對象用于對支持Odbc的數(shù)據(jù)庫執(zhí)行命令。盡管SqlCommand類是針對Sql Server的,但是這個(gè)類的許多屬性、方法與事件和OleDbCommand及OdbcCommand等類相似。本章將重點(diǎn)講解SqlCommand特定的屬性與方法,其他的Command類你可以參考相應(yīng)的幫助文檔。
注意:使用不同的Command對象需要導(dǎo)入不同的命名空間。OleDbCommand的命名空間為System.Data.OleDb。SqlCommand的命名空間為System.Data.SqlClient。OdbcCommand的命名空間為System.Data.Odbc。
SqlCommand屬性:
屬性 | 說明 |
CommandText | 其返回類型為string, 獲取或設(shè)置要對數(shù)據(jù)源執(zhí)行的 SQL 語句、存儲(chǔ)過程或表。 |
CommandTimeOut | 其返回類型為int,獲取或設(shè)置在終止執(zhí)行命令的嘗試并生成錯(cuò)誤之前的等待時(shí)間。 |
CommandType | 其返回類型為CommandType,讀取或設(shè)置表示CommandText屬性將如何被解釋的值,其有效的值可以為CommandType.Text、CommandType.StoredProcedur與CommandType.TableDirect,分別表示SQL語句、存儲(chǔ)過程調(diào)用或要讀取的表,默認(rèn)為Text。 |
Connection | 其返回類型為string, 獲取或設(shè)置 SqlCommand 的此實(shí)例使用的 SqlConnection。 |
Parameters | 其返回類型為SqlParameterCollection,取得提供給命令的參數(shù)(如有)。 |
SqlCommand方法:
方法 | 說明 |
Cancle() | 其返回類型為void,取消命令的執(zhí)行 |
CreateParameter() | 其返回類型為SqlParameter, 用于創(chuàng)建 SqlParameter 對象的新實(shí)例。 |
ExecuteNonQuery() | 其返回類型為int,執(zhí)行不返回結(jié)果集的Sql語句,包括INSERT、UPDATE與DELETE語句、DDL語句和不返回結(jié)果集的存儲(chǔ)過程調(diào)用。返回的int值是命令影響的數(shù)據(jù)庫行數(shù)。 |
ExecuteReader() | 其返回類型為SqlDataReader, 執(zhí)行SELECT語句、TableDirect命令或返回結(jié)果集的存儲(chǔ)過程調(diào)用。在SqlDataReader對象中返回結(jié)果集。 |
ExecuteScalar() | 其返回類型為object,執(zhí)行返回單個(gè)值的SELECT語句(任何其他的值將被忽略)。這個(gè)命令結(jié)果作為對象被返回。 |
ExecuteXmlReader() | 其返回類型為XmlReader,執(zhí)行返回XML數(shù)據(jù)的SELECT語句,用XmlReader對象返回結(jié)果集,只適用于SqlCommand類 |
生成SqlCommand對象
我們可以用構(gòu)造函數(shù)生成SqlCommand對象,也可以調(diào)用SqlConnection對象的CreateCommand()方法生成SqlCommand對象,下面分別介紹這兩種方法。
用構(gòu)造函數(shù)生成SqlCommand對象
SqlCommand對象的構(gòu)造函數(shù)如下所示:
SqlCommand() SqlCommand(string commandText) SqlCommand(string commandText,SqlConnection mySqlConnection) |
程序代碼說明:在上述語法范例的程序代碼中,commandText包含SQL語句、存儲(chǔ)過程調(diào)用或要讀取的表。mySqlConnection是對應(yīng)的SqlConnection對象。
在使用SqlCommand對象之前,首先要確定一個(gè)SqlConnection對象,用于和SQL Server數(shù)據(jù)庫進(jìn)行數(shù)據(jù)傳遞。
mySqlConnection.ConnectionString="server=localhost;database=Northwind; integrated security=SSPI"; |
然后可以用下列語句生成新的SqlCommand對象:
SqlCommand mySqlCommand=new SqlCommand(); |
再將mySqlCommand對象的Connection屬性設(shè)置為mySqlConnection:
mySqlCommand.Connection= mySqlConnection; |
這樣mySqlCommand對象就可以使用mySqlConnection與數(shù)據(jù)庫進(jìn)行數(shù)據(jù)傳遞,F(xiàn)在,Command對象的CommandType屬性確定要執(zhí)行的命令類型?梢杂肧ystem.Data.CommandType枚舉值指定CommandType屬性。
CommandType的枚舉值如下表所示:
數(shù)值 | 說明 |
Text | 表示命令是SQL語句,默認(rèn)值是Text |
StoredProcedure | 表示命令是儲(chǔ)存過程調(diào)用 |
TableDirect | 表示被讀取的行和列的表名。注意:SqlCommand對象不支持TableDirect,要使用其他的Command類的對象。 |
例如你可以采用如下的形式執(zhí)行一個(gè)SQL查詢:
SqlCommand mySqlCommand=new SqlCommand(); mySqlCommand.Connection=mySqlConnection; mySqlCommand.CommandText=”SELECT * FROM Employees”; //mySqlCommand.CommandType=CommandType.Text; |
程序代碼說明:在上述語法范例的程序代碼中,我們設(shè)置了mySqlCommand對象的commandText為一個(gè)SELECT查詢語句,并且指定了mySqlCommand對象的CommandType屬性為CommandType.Text,表示命令是SQL語句。由于CommandType.Text是默認(rèn)的CommandType值,所以我們可以將其注譯掉。
還有一個(gè)更具效率的形式,那就是使用SqlCommand對象的其中一種構(gòu)造函數(shù):
SqlCommand mySqlCommand=new SqlCommand(”SELECT * FROM Employees”,myConnection); |
程序代碼說明:在上述語法范例的程序代碼中,我們可以直接利用SqlCommand(string commandText,SqlConnection mySqlConnection) 構(gòu)造函數(shù),從而使得程序代碼更加的簡練和直觀。
還可以使用儲(chǔ)存過程來查詢所需要的數(shù)據(jù),我們可以采用如下的代碼形式:
SqlCommand mySqlCommand=new SqlCommand(”GetEmpolyees”,myConnection); mySqlCommand.CommandType=CommandType.StoredProcedure; |
程序代碼說明:在上述語法范例的程序代碼中,GetEmpolyees為一個(gè)儲(chǔ)存過程名,用來實(shí)現(xiàn)所有的雇員信息查詢。并且將CommandType值指定為StoredProcedure,表示命令是儲(chǔ)存過程調(diào)用。
使用CreateCommand()方法生成SqlCommand對象
如果不用構(gòu)造函數(shù),也可以使用SqlConnection對象的CreateCommand()方法生成SqlCommand對象。這個(gè)方法返回新的SqlCommand對象。例如:
SqlCommand mySqlCommand=mySqlConnection.CreateCommand(); |
SqlDataReader類
可以用SqlDataReader類對象從SQL Server數(shù)據(jù)庫中讀取行;用OleDbDataReader類對象從支持OLE DB的數(shù)據(jù)庫中讀行,如Oracle與Access;用OdbcDataReader類對象從支持ODBC的數(shù)據(jù)庫中讀取行。
DataReader對象允許你以向前的,只讀的方式讀取數(shù)據(jù),有時(shí)候DataReader對象也稱為消軟管游標(biāo)。DataReader對象采用了一種簡化的數(shù)據(jù)讀取方式,但是提高了性能的同時(shí)也犧牲了很多特性。例如在DataSet中支持的排序,分頁等功能。這些功能將在以后的章節(jié)進(jìn)行詳細(xì)的介紹。
SqlDataReader的屬性
屬性 | 說明 |
Depth | 其返回類型為int,取得表示當(dāng)前行嵌入深度的值 |
FieldCount | 其返回類型為int,取得當(dāng)前行的列數(shù) |
IsColsed | 其返回類型為bool,取得一個(gè)布爾值,表示是否關(guān)閉數(shù)據(jù)讀取 |
RecordsAffected | 其返回類型為int, 取得執(zhí)行SQL語句增加、修改或刪除的行數(shù)。 |
SqlDataReader的方法
方法 | 說明 |
Reader() | 其返回類型為bool,將數(shù)據(jù)閱讀器移到結(jié)果集的下一行并讀取該行。這個(gè)方法返回的布爾值表示結(jié)果集中是否有多行 |
GetValue() | 其返回類型為object, 返回指定列的值 |
GetValues() | 其返回類型為int,將當(dāng)前行中所有列的值復(fù)制到指定對象數(shù)組。這個(gè)方法返回的int是數(shù)組元素的個(gè)數(shù) |
NextResult() | 其返回類型為bool,將數(shù)據(jù)閱讀器移到結(jié)果集的下一行。這個(gè)方法返回的布爾值表示結(jié)果集中是否有多行 |
Close() 關(guān)閉 | SqlDataReader 對象 |
GetInt32(),GetChar(), GateDataTime(),Get×××() |
返回指定列的值,并且返回的類型為相應(yīng)的數(shù)據(jù)類型。例如GetInt32()返回整型的數(shù)值。注意,如果你將返回值賦予一個(gè)類型不匹配的變量時(shí),將會(huì)拋出一個(gè)InvalidCastException異常 |
用ExecuteReader()方法執(zhí)行查詢
下面是一個(gè)用ExecuteReader()方法執(zhí)行SELECT語句的范例。這個(gè)方法用DataReader對象返回結(jié)果集,然后可以用此對象讀取數(shù)據(jù)庫返回的行。
范例程序代碼如下:
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行代碼生成所要的對象并執(zhí)行SELECT語句,從Customers表中讀取前5條記錄。cmd返回的結(jié)果集存放在reader對象中,然后你可以用Reader()方法讀取reader對象的記錄。這個(gè)方法在有另一個(gè)可讀的行時(shí)返回布爾真值,否則返回布爾假值?梢詮膔eader對象中讀取一個(gè)記錄的各個(gè)列值,只要在方括號中傳入列名即可。如第16和17行所示,我們用reader[“CustomerID”]讀取CustomerID列的各項(xiàng)內(nèi)容。你也可以直接在方括號中傳入數(shù)字值指定想要列的索引。如第18和19行代碼所顯示,由于我們在用SELECT進(jìn)行數(shù)據(jù)查詢的時(shí),ContactName和Address分別位于第3和第4列,而相應(yīng)的索引值則為2和3,所以我們可以用reader.GetString(2)和reader.GetString(3)讀取ContactName和Address列的數(shù)據(jù)。如第14行代碼所示,我們可以在While循環(huán)中用Reader()方法一一讀取每條記錄。
執(zhí)行結(jié)果:
每次程序執(zhí)行命令時(shí),都要將相應(yīng)的命令通過網(wǎng)絡(luò)傳遞到數(shù)據(jù)庫中,并在數(shù)據(jù)庫進(jìn)行執(zhí)行,然后將結(jié)果返回到程序中,從而產(chǎn)生大量的網(wǎng)絡(luò)通信流。我們可以使用ExecuteReader()方法同時(shí)執(zhí)行多條SELECT語句查詢減少重復(fù)的數(shù)據(jù)傳遞。
下面的實(shí)例是使用ExecuteReader()方法同時(shí)查詢?nèi)齻(gè)表中的數(shù)據(jù),并將返回的三個(gè)結(jié)果集顯示在頁面上。
范例程序代碼如下:
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("結(jié)果集"); 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個(gè)查詢語句,各語句之間用分號進(jìn)行間隔。第16行調(diào)用ExecuteReader()方法,并返回SqlDataReader對象,并且對三條不同的SELECT語句各返回一個(gè)結(jié)果集。要讀取第一個(gè)結(jié)果集的話,可以用SqlDataReader對象的Reader()方法。Reader()方法在沒有其他的可讀行時(shí)將返回一個(gè)false值。當(dāng)一個(gè)結(jié)果集的所有記錄都讀取完畢后,可以調(diào)用SqlDataReader對象的NextResult()方法,然后在讀取下一個(gè)結(jié)果集,在沒有其他的結(jié)果集時(shí),也返回一個(gè)false值。
提示:外循環(huán)do…while測試結(jié)尾的reader. NextResult()的返回值。由于do…while循環(huán)末尾檢測這個(gè)條件,這樣就保證了do…while循環(huán)至少執(zhí)行一次。之所以在末尾才調(diào)用NextResult()方法,是因?yàn)檫@樣可以首先把SqlDataReader對象移到下一個(gè)結(jié)果集,然后才返回表示是否還有下一個(gè)結(jié)果集的布爾結(jié)果。如果使用while循環(huán)中,則有可能直接跳過第一個(gè)結(jié)果集,從而產(chǎn)生錯(cuò)誤。
用ExecuteScalar()方法執(zhí)行SELECT語句
用ExecuteScalar()方法執(zhí)行SELECT語句,返回單個(gè)值,并且忽略其他的任何讀取的結(jié)果。ExecuteScalar()方法返回的結(jié)果是一個(gè)object對象。ExecuteScalar()主要是用來執(zhí)行SELECT語句,或者執(zhí)行包括聚合函數(shù)的SQL語句。
下面我們將使用如下的程序讀取Products表中的記錄條數(shù),并且在相應(yīng)的查詢語句中使用COUNT()聚合函數(shù)。
范例程序代碼如下:
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表中的記錄條數(shù)的SQL語句。第11行代碼用ExecuteScalar()方法執(zhí)行SELECT語句。注意,由于ExecuteScalar()方法的結(jié)果為object對象,因此我們要將其進(jìn)行強(qiáng)制類型轉(zhuǎn)換,再賦予相應(yīng)的變量。
執(zhí)行結(jié)果: