# 0.前言 在上一篇中初略的介紹了一下SQL的基本寫法，這一篇開始我們正式步入C#操作資料庫的範圍。通過這一系列的內容，我想大家能對於資料庫互動有了一定的認識和基礎。閒話不多說，先給大家介紹一個C#操作資料庫的方式。 # 1. ADO.NET的介紹 在ADO.NET出現之前，C#連線資料庫有很多種方式，各種框架琳琅滿目。使用者們飽受困擾，再加上亂七八糟的連線方式對語言的發展也是一種強有力的阻撓。所以微軟決定搞一套標準化出來，之後ADO.NET誕生了。 ADO.NET定義了一系列操作資料庫的介面和基類，而資料庫廠商只需要根據自己的實際情況開發對應的實現類就可以了。 # 2. 使用ADO.NET 操作需要的步驟 使用ADO.NET操作資料庫，先需要一個連線也就是 IDbConnection例項，然後使用IDbCommand執行，通過 IDataReader讀取資料。 先來簡單介紹一下上面提到的介面： **a.IDbConnection** 表示一個與資料來源的開放連線，並由訪問關係資料庫的.NET 資料提供程式實現，也就是說這只是一個介面，具體的實現得看具體的資料庫。 我們先看一下，具體的屬性和方法吧： ```c# public string ConnectionString { get; set; }// 獲取或設定用於開啟資料庫的連線字串 public string Database { get; }//獲取當前連線或即將連線的資料庫名稱 public System.Data.ConnectionState State { get; }//獲取當前連線的狀態 public System.Data.IDbTransaction BeginTransaction ();//開啟一項資料庫事務 public void ChangeDatabase (string databaseName);//修改已開啟連線的當前資料庫 public void Close ();//關閉當前連線 public System.Data.IDbCommand CreateCommand ();//建立並獲取與該連線關聯的命令物件 public void Open ();//開啟與資料庫的連線 ``` **b. IDbCommand** 表示連線到資料來源時執行的SQL命令，並由訪問關係資料庫的.NET資料提供程式實現。與IDbConnection一致，也是一個介面。 這個介面的屬性和方法如下： ```c# public string CommandText { get; set; } //獲取或設定要對資料來源執行的文字命令，也就是SQL語句 public int CommandTimeout { get; set; } //獲取或設定在終止嘗試執行命令並生成錯誤之前的等待時間 public System.Data.CommandType CommandType { get; set; }//指定或者獲取解釋CommandText屬性的方式 public System.Data.IDbConnection Connection { get; set; }//獲取或設定執行該命令的連線 public System.Data.IDataParameterCollection Parameters { get; }//獲取命令的引數化列表 public System.Data.IDbTransaction Transaction { get; set; }//獲取或設定該命令關聯的事務 public void Cancel ();//嘗試取消執行命令 public System.Data.IDbDataParameter CreateParameter ();//建立一個引數 public int ExecuteNonQuery ();//執行一個語句，並返回受影響的行數 public System.Data.IDataReader ExecuteReader ();//在Connect上執行CommandText，並返回一個IDataReader public object ExecuteScalar ();//執行查詢，並返回第一行第一列，其他資料忽略 ``` **c. IDataReader** 提供一種讀取結果集（通過對資料來源執行命令獲取）的一個或多個只進流的方法，具體實現由訪問關係資料庫的.NET 資料提供程式實現。 這裡的只進流的意思類似於只讀流，也就是說它是一種單向的流，從資料庫傳向程式的流。 這個介面的屬性和方法如下： ```c# public int Depth { get; }//獲取一個值，該值指示當前行的巢狀深度 public bool IsClosed { get; }// 獲取該讀取器的是否關閉 public int RecordsAffected { get; }//獲取由執行 SQL 語句而更改、插入或刪除的行數 public void Close ();//關閉IDataReader物件 public System.Data.DataTable GetSchemaTable ();//獲取一個描述該讀取器關聯的列元資料 public bool NextResult ();//顯示是否有下一行，如果有則在下次讀取的時候，讀取下一行的資料 public bool Read ();//與NextResult類似 ``` 同時，IDataReader 繼承了介面 IDataRecord，也就是說IDataReader也能直接返回當前行的資料。 來，我們看看它從IDataRecord繼承了哪些吧（也就是IDataRecord有的屬性和方法）。 ```c# public int FieldCount { get; }//獲取當前行中的列數 public object this[int i] { get; }//獲取位於指定索引處的列 public object this[string name] { get; }//獲取具有指定名稱的列 public System.Data.IDataReader GetData (int i);//獲取指定列序號的DataReader public Type GetFieldType (int i);//獲取對應於會從 Type 返回的 Object 型別的 GetValue(Int32) 資訊 public string GetDataTypeName (int i);//獲取指定欄位的資料型別資訊 public string GetName (int i);//獲取要查詢的欄位的名稱 public int GetOrdinal (string name);//返回命名欄位的索引 public bool GetBoolean (int i);//作為布林值獲取指定列的值 public byte GetByte (int i);//獲取指定列的 8 位無符號整數值 public char GetChar (int i);//獲取指定列的字元值 public DateTime GetDateTime (int i);//獲取指定欄位的日期和時間資料值 public decimal GetDecimal (int i);//獲取指定欄位的數值 public double GetDouble (int i);//獲取指定欄位的雙精度浮點數 public float GetFloat (int i);//獲取指定欄位的單精度浮點數 public Guid GetGuid (int i);//獲取指定欄位的GUID值 public short GetInt16 (int i);//獲取指定欄位的 16 位帶符號整數值 public long GetInt64 (int i);//獲取指定欄位的 64 位帶符號整數值 public string GetString (int i);//獲取指定欄位的字串值 public object GetValue (int i);//返回指定欄位的值 public int GetValues (object[] values);// 將當前記錄的值按順序填充到陣列中，並返回實際的數目 public bool IsDBNull (int i);//返回指定欄位是否設定為 null ``` **特別補充說明** ConnectionState 是一個列舉狀態，表示資料連線狀態，其屬性值如下： | 欄位 | 值 | 說明 | | :--------- | :------: | :----------------------------------------------------------- | | Broken | 16 | 與資料來源的連線中斷。 只有在連線開啟之後才可能發生這種情況。 可以關閉處於這種狀態的連線，然後重新開啟。 （該值是為此產品的未來版本保留的。） | | Closed | 0 | 連線已關閉。 | | Executing | 4 | 連線物件正在執行命令。 （該值是為此產品的未來版本保留的。） | | Fetching | 8 | 連線物件正在檢索資料。 （該值是為此產品的未來版本保留的。） | | Open | 1 | 連線處於開啟狀態。 | CommandType 用來指定如何解釋命令字串，屬性值如下： | 欄位 | 值 | 說明 | | --------------- | ---- | ------------------------- | | StoredProcedure | 4 | 儲存過程的名稱。 | | TableDirect | 512 | 表的名稱。 | | Text | 1 | SQL 文字命令。 （預設。） | # 3. 如何使用ADO.NET操作資料庫 以SQLServer為例，建立一個Connection： ```c# using System.Data; using System.Data.SqlClient;//Sql Server的名稱空間 ``` ```c# string connectStr = ""; IDbConnection connection = new SqlConnection(connectStr); ``` 在.NET Framework中，以上程式碼是正確的，因為.NET Framework內建了SQL Server的資料訪問程式，也就是資料驅動。但是在.NET Core中，需要為專案新增如下包的引用： > System.Data.SqlClient 這裡簡單介紹一下如何使用Visual Studio安裝包：  如圖所示，在【工具】->【NuGet 包管理器】下找到 管理解決方案的NuGet程式包，點選。然後會出現類似於下圖：  然後點選瀏覽，輸入：System.Data.SqlClient  選中第一項，然後在右側勾選要新增包的專案，然後點選安裝。 OK，現在假設你們都已經安裝好了。然後繼續下一步操作： 執行一個查詢語句： ```sql select name from demo; ``` 建立一個Command： 這時候建立Command有這樣幾種方式： ```c IDbCommand command = connection.CreateCommand();// 通過 connection建立一個命令 IDbCommand command = new SqlCommand();//簡單建立一個命令物件 IDbCommand command = new SqlCommand(sql,connection);//在初始化的時候，指定要執行的SQL和連線的Connection ``` 如果在建立Command的時候，沒有指定連線和要執行的SQL語句，那麼必須在獲取Reader之前，手動設定。 現在獲取一個Reader： ```c# IDataReader reader = command.ExecuteReader(); ``` 如果只是想執行SQL，不關心返回內容的話，可以呼叫以下方法： ```c# int lines = command.ExecuteNonQuery();// 獲取受影響的行數 ``` 該方法適合於SQL是DML型別的SQL語句或者增刪改的SQL語句。 如果是查詢語句，則需要獲取Reader，然後通過Reader獲取對應的值。 # 4. 實踐 在大概講解了SQL，我們通過實踐練習把之前瞭解到的內容串聯起來。 **a.建立一個表** ```c# var connectStr = ""; var sql = @"create table demo ( [key] int identity primary key, [name] varchar(20) )"; IDbConnection connection = new SqlConnection(connectStr); IDbCommand command = connection.CreateCommand(); connection.Open();//開啟連結 command.CommandText = sql;//賦值sql var result = command.ExecuteNonQuery();//獲取返回的int值，是-1 connection.Close();//用完了記得把連結關閉 ``` 對於 ExcuteNonQuery的返回值，微軟在官方文件中給出了這樣的描述： > 對於 UPDATE、INSERT 和 DELETE 語句，返回值為該命令所影響的行數。 對於所有其他型別的語句，返回值是 -1。 所以這裡的返回值是-1。 **b.新增一條資料** 與建立表類似，區別在於使用的SQL語句不同。在C#中，使用ADO.NET 向資料庫新增值，需要手動拼接SQL語句來操作。 程式碼如下：（假設使用在上一個示例裡建立的表） 拼接SQL： ```c# var value1 = "測試"; var sql = @$"insert into demo(name) values('{value1}');"; //====或者 var sql = string.Format("insert into demo(name) values('{0}');", "測試"); ``` 注意SQL語句拼接過程中的單引號，這在SQL中表示中間是字串。SQL有很強的將字串轉換成對應欄位型別的能力，所以可以統一傳給資料庫字串。 執行SQL： ```c# var connectStr = ""; IDbConnection connection = new SqlConnection(connectStr); IDbCommand command = connection.CreateCommand(); connection.Open(); command.CommandText = sql; var result = command.ExecuteNonQuery(); connection.Close(); ``` 這次如果沒有執行錯誤的話，會返回一個1。 **c.修改記錄** 例如修改demo裡name為**測試**的資料，將其name修改為**demo**： ```c# var connectStr = ""; var sql = "update demo set name = 'demo' where name = ‘測試’"; IDbConnection connection = new SqlConnection(connectStr); IDbCommand command = connection.CreateCommand(); connection.Open(); command.CommandText = sql; var result = command.ExecuteNonQuery(); Console.WriteLine(result); connection.Close(); ``` 其中result表示SQL影響的表中資料行數。 **d. 刪除記錄** ```c# var sql = "delete table demo where name = ‘測試’"; IDbConnection connection = new SqlConnection(connectStr); IDbCommand command = connection.CreateCommand(); connection.Open(); command.CommandText = sql; var result = command.ExecuteNonQuery(); Console.WriteLine(result); connection.Close(); ``` **e. 查詢** 這裡就先容我賣個關子，不過大家可以自己試試ADO.NET的查詢 # 5. 說明 在第四小節裡提到了連線字串，對於C#來說，不同資料庫應當有不同的連線字串。因為這是C#連線資料庫的一種指令或者是金鑰。 簡單介紹一下連線字串，它是用分號隔開的鍵值對列表。格式如下： ``` keyword1=value; keyword2=value; ``` 以下是一個標準的SQL Server連線字串： ``` Persist Security Info=False;User ID=*****;Password=*****;Initial Catalog=AdventureWorks;Server=MySqlServer ``` 其中： - Persist Security Info=False 表示使用賬戶密碼連線資料庫 - User ID 表示使用者名稱 - Password 表示密碼 - Initial Catalog=AdventureWorks 表示連線的資料庫是 AdventureWorks ，可根據自己需要修改 - Server=MySqlServer 表示資料庫在 MySqlServer 這個伺服器上，可以是IP地址或者域名等 之所以留下了查詢沒有說，因為在ADO.NET中還有一種更棒的方式操作資料庫。這就是下篇內容要講的。如果有需要的小夥伴，別忘了關注評論哈。 > 更多內容煩請關注[我的部落格《高先生小屋》](https://www.attachie.club)