資料庫命令執行時使用Command對象。Command類有三種:SqlCommand、OleDbCommand與OdbcCommand。
Command對象主要用來運行SELECT、INSERT、UPDATE或DELETE之類的SQL語句。Command對象還可以調用預存程序或從特定表中取得記錄。
DataReader對象主要是用來讀取資料結果,使用它讀取記錄時通常比從DataSet更快。DataReader類有三種:SqlDataReader、OleDbDataReader和OdbcDataReader。DataReader對象用Commmand對象從資料庫中讀取記錄,並且DataReader對象只能向前的讀取記錄,用於在某些情況下替代DataSet對象(DataSet對象可以儲存資料庫中的行拷貝,可以在切斷資料庫的串連時處理這個拷貝,我們將在以後的章節中詳細介紹該對象)。
注意:不能用DataReader修改資料庫中的記錄,它是採用向前的,唯讀方式讀取資料庫。
SqlCommand類
SqlCommand對象用於對Sql Server資料庫執行命令。OleDbCommand對象用於對支援OleDb的資料庫執行命令,如Oracle與Access。OdbcCommand對象用於對支援Odbc的資料庫執行命令。儘管SqlCommand類是針對Sql Server的,但是這個類的許多屬性、方法與事件和OleDbCommand及OdbcCommand等類相似。本章將重點講解SqlCommand特定的屬性與方法,其他的Command類你可以參考相應的協助文檔。
注意:使用不同的Command對象需要匯入不同的命名空間。OleDbCommand的命名空間為System.Data.OleDb。SqlCommand的命名空間為System.Data.SqlClient。OdbcCommand的命名空間為System.Data.Odbc。
SqlCommand屬性:
| 屬性 |
說明 |
| CommandText |
其傳回型別為string, 擷取或設定要對資料來源執行的 SQL 陳述式、預存程序或表。 |
| CommandTimeOut |
其傳回型別為int,擷取或設定在終止執行命令的嘗試並建置錯誤之前的等待時間。 |
| CommandType |
其傳回型別為CommandType,讀取或設定表示CommandText屬性將如何被解釋的值,其有效值可以為CommandType.Text、CommandType.StoredProcedur與CommandType.TableDirect,分別表示SQL語句、預存程序調用或要讀取的表,預設為Text。 |
| Connection |
其傳回型別為string, 擷取或設定 SqlCommand 的此執行個體使用的 SqlConnection。 |
| Parameters |
其傳回型別為SqlParameterCollection,取得提供給命令的參數(如有)。 |
SqlCommand方法:
| 方法 |
說明 |
| Cancle() |
其傳回型別為void,取消命令的執行 |
| CreateParameter() |
其傳回型別為SqlParameter, 用於建立 SqlParameter 對象的新執行個體。 |
| ExecuteNonQuery() |
其傳回型別為int,執行不返回結果集的Sql語句,包括INSERT、UPDATE與DELETE語句、DDL語句和不返回結果集的預存程序調用。返回的int值是命令影響的資料庫行數。 |
| ExecuteReader() |
其傳回型別為SqlDataReader, 執行SELECT語句、TableDirect命令或返回結果集的預存程序調用。在SqlDataReader對象中返回結果集。 |
| ExecuteScalar() |
其傳回型別為object,執行返回單個值的SELECT語句(任何其他的值將被忽略)。這個命令結果作為對象被返回。 |
| ExecuteXmlReader() |
其傳回型別為XmlReader,執行返回XML資料的SELECT語句,用XmlReader對象返回結果集,只適用於SqlCommand類 |
產生SqlCommand對象
我們可以用建構函式產生SqlCommand對象,也可以調用SqlConnection對象的CreateCommand()方法產生SqlCommand對象,下面分別介紹這兩種方法。
用建構函式產生SqlCommand對象
SqlCommand對象的建構函式如下所示:
SqlCommand() SqlCommand(string commandText) SqlCommand(string commandText,SqlConnection mySqlConnection) |
程式碼說明:在上述文法範例的程式碼中,commandText包含SQL語句、預存程序調用或要讀取的表。mySqlConnection是對應的SqlConnection對象。
在使用SqlCommand對象之前,首先要確定一個SqlConnection對象,用於和SQL Server資料庫進行資料傳遞。
mySqlConnection.ConnectionString="server=localhost;database=Northwind; integrated security=SSPI"; |
然後可以用下列語句產生新的SqlCommand對象:
| SqlCommand mySqlCommand=new SqlCommand(); |
再將mySqlCommand對象的Connection屬性設定為mySqlConnection:
| mySqlCommand.Connection= mySqlConnection; |
這樣mySqlCommand對象就可以使用mySqlConnection與資料庫進行資料傳遞。現在,Command對象的CommandType屬性確定要執行的命令類型。可以用System.Data.CommandType枚舉值指定CommandType屬性。
CommandType的枚舉值如下表所示:
| 數值 |
說明 |
| Text |
表示命令是SQL語句,預設值是Text |
| StoredProcedure |
表示命令是儲存程序呼叫 |
| TableDirect |
表示被讀取的行和列的表名。注意:SqlCommand對象不支援TableDirect,要使用其他的Command類的對象。 |
例如你可以採用如下的形式執行一個SQL查詢:
SqlCommand mySqlCommand=new SqlCommand(); mySqlCommand.Connection=mySqlConnection; mySqlCommand.CommandText=”SELECT * FROM Employees”; //mySqlCommand.CommandType=CommandType.Text; |
程式碼說明:在上述文法範例的程式碼中,我們設定了mySqlCommand對象的commandText為一個SELECT查詢語句,並且指定了mySqlCommand對象的CommandType屬性為CommandType.Text,表示命令是SQL語句。由於CommandType.Text是預設的CommandType值,所以我們可以將其註譯掉。
還有一個更具效率的形式,那就是使用SqlCommand對象的其中一種建構函式:
| SqlCommand mySqlCommand=new SqlCommand(”SELECT * FROM Employees”,myConnection); |
程式碼說明:在上述文法範例的程式碼中,我們可以直接利用SqlCommand(string commandText,SqlConnection mySqlConnection) 建構函式,從而使得程式碼更加的簡練和直觀。
還可以使用儲存過程來查詢所需要的資料,我們可以採用如下的代碼形式:
SqlCommand mySqlCommand=new SqlCommand(”GetEmpolyees”,myConnection); mySqlCommand.CommandType=CommandType.StoredProcedure; |
程式碼說明:在上述文法範例的程式碼中,GetEmpolyees為一個儲存過程名,用來實現所有的僱員資訊查詢。並且將CommandType值指定為StoredProcedure,表示命令是儲存程序呼叫。
使用CreateCommand()方法產生SqlCommand對象
如果不用建構函式,也可以使用SqlConnection對象的CreateCommand()方法產生SqlCommand對象。這個方法返回新的SqlCommand對象。例如:
| SqlCommand mySqlCommand=mySqlConnection.CreateCommand(); |
*********************************************************************
using (System.Data.OracleClient.OracleDataAdapter da = new OracleDataAdapter(cmd))
{
DataSet ds = new DataSet();
da.Fill(ds);
cmd.Parameters.Clear();
return ds;
}
OleDbCommand cmd=conn.CreateCommand();
cmd.CommandText="select max(id) as maxid from ware";
OleDbDataReader thisReader=cmd.ExecuteReader();
while (thisReader.Read())
{
m_id=thisReader.GetInt16(0)+1;
}
而不是這樣處理:
if(thisReader.HasRows)
{
m_id=thisReader.GetInt16(0)+1;
//執行到上面這句時出錯:不存在此行或列,但是直接執行select max(id) as maxid from ware是成功的,有記錄。那裡出錯了?
}