萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

ADO.NET 核心類別速查手冊:SqlConnection、SqlCommand、DataReader、DataAdapter 完整用法

一、SqlConnection 連線管理

命名空間

using System.Data.SqlClient;

建立與開啟連線

// 方式 1:屬性設定
var conn = new SqlConnection();
conn.ConnectionString = "User ID=sa;Password=***;Initial Catalog=Test;Data Source=127.0.0.1;Connect Timeout=30";
conn.Open();

// 方式 2:建構子傳入 (推薦)
string connStr = "User ID=sa;Password=***;Database=Test;Server=127.0.0.1;Connect Timeout=30";
using (var conn = new SqlConnection(connStr)) {
    conn.Open();
    // ...
}

連線字串關鍵屬性

屬性說明範例
Server / Data Source伺服器位址127.0.0.1、.(本機)、ServerName\Instance
Database / Initial Catalog資料庫名稱TestDB
User ID / PasswordSQL 驗證帳密sa / P@ssw0rd
Integrated Security / Trusted_ConnectionWindows 整合驗證true / SSPI
Connect Timeout連線逾時秒數30
Pooling / Min Pool Size / Max Pool Size連線池控制true / 0 / 100
MultipleActiveResultSets (MARS)單連線多結果集true

二、OleDbConnection 通用連線 (Access/Oracle/舊版 SQL)

// SQL Server (OLE DB)
"Provider=SQLOLEDB;Data Source=localhost;Initial Catalog=Test;Integrated Security=SSPI;"

// Access (Jet/ACE)
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\Data\\db.mdb;Persist Security Info=False;"
"Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\\Data\\db.accdb;Persist Security Info=False;"

// Oracle (MSDAORA - 已淘汰,建議用 ODP.NET)
"Provider=MSDAORA;Data Source=ORCL;User ID=scott;Password=tiger;"

三、SqlCommand 命令物件

四種建構子

// 1. 無參數
var cmd = new SqlCommand();

// 2. 僅 SQL 文字
var cmd = new SqlCommand("SELECT * FROM Products");

// 3. SQL + 連線
var cmd = new SqlCommand("SELECT * FROM Products", conn);

// 4. SQL + 連線 + 交易
var cmd = new SqlCommand("SELECT * FROM Products", conn, tx);

關聯連線與交易

cmd.Connection = conn;                    // 或 conn.CreateCommand()
cmd.Transaction = tx;                     // 參與交易
cmd.CommandText = "SELECT * FROM Products";
cmd.CommandType = CommandType.Text;       // Text / StoredProcedure / TableDirect

多重結果集

cmd.CommandText = "SELECT * FROM Table1; SELECT * FROM Table2;"; // 分號分隔
using (var reader = cmd.ExecuteReader()) {
    do {
        while (reader.Read()) { /* 處理第一個結果集 */ }
    } while (reader.NextResult()); // 移至下一個結果集
}

四大執行方法

方法回傳適用場景
ExecuteReader()SqlDataReaderSELECT、多列/多欄
ExecuteNonQuery()int (影響列數)INSERT/UPDATE/DELETE、DDL
ExecuteScalar()object (第一列第一欄)COUNT(*), SUM(), 單一值
ExecuteXmlReader()XmlReaderFOR XML 查詢

四、SqlDataReader 高效讀取

三種存取方式

// 1. 序數索引器 (最快)
while (reader.Read()) {
    Console.WriteLine($"{reader[0]} {reader[1]}");
}

// 2. 名稱索引器 (可讀性佳)
while (reader.Read()) {
    Console.WriteLine($"{reader["Code"]} {reader["Name"]}");
}

// 3. 強型別 GetXxx (避免裝箱、Null 檢查)
while (reader.Read()) {
    int id = reader.GetInt32(0);
    string name = reader.IsDBNull(1) ? null : reader.GetString(1);
    DateTime dt = reader.GetDateTime(2);
}

中繼資料取得

int fieldCount = reader.FieldCount;
Type fieldType = reader.GetFieldType(ordinal);
string typeName = reader.GetDataTypeName(ordinal);
string colName = reader.GetName(ordinal);
int ordinal = reader.GetOrdinal("ColumnName");
DataTable schemaTable = reader.GetSchemaTable(); // 詳細欄位結構

多結果集處理

do {
    while (reader.Read()) { /* ... */ }
} while (reader.NextResult());

五、SqlDataAdapter 離線資料集

建立方式

// 1. 無參數
var da = new SqlDataAdapter();

// 2. SelectCommand 為 SqlCommand
var da = new SqlDataAdapter(selectCmd);

// 3. SQL 文字 + 連線
var da = new SqlDataAdapter("SELECT * FROM Products", conn);

// 4. SQL 文字 + 連線字串
var da = new SqlDataAdapter("SELECT * FROM Products", connStr);

手動指定四大命令

da.SelectCommand = new SqlCommand("SELECT * FROM Products", conn);
da.InsertCommand = new SqlCommand("INSERT INTO Products (Name) VALUES (@Name)", conn);
da.UpdateCommand = new SqlCommand("UPDATE Products SET Name=@Name WHERE Id=@Id", conn);
da.DeleteCommand = new SqlCommand("DELETE FROM Products WHERE Id=@Id", conn);
// 參數對應需手動設定或使用 CommandBuilder

Fill 方法多載

da.Fill(dataSet);                    // 新增 Table0, Table1...
da.Fill(dataSet, "Products");        // 指定 DataTable 名稱
da.Fill(dataSet, 0, 10, "Products"); // 分頁:起始 0、最多 10 列
da.Fill(dataTable);                  // 直接填充 DataTable
da.Fill(dataTable, reader);          // 從 IDataReader 填充

Update 批次同步

// 自動產生 Insert/Update/Delete 命令 (需 SelectCommand 有主鍵)
var cb = new SqlCommandBuilder(da);
da.Update(dataSet, "Products"); // 根據 RowState 自動執行對應命令

六、OleDbCommand / OleDbDataAdapter 同構用法

將 Sql 前綴改為 OleDb,連線字串對應即可,API 幾乎相同。

七、最佳實務速查表

  1. 永遠 using:Connection、Command、Reader、Adapter、Transaction。
  2. 參數化:cmd.Parameters.Add("@p", SqlDbType.Int).Value = 1;。
  3. 明確指定 CommandType:StoredProcedure 時必須設定。
  4. DataReader 讀取順序:循序讀取,不可跳躍;需隨機存取請用 DataTable。
  5. 大欄位 (BLOB/XML):CommandBehavior.SequentialAccess + GetBytes/GetChars 串流。
  6. 連線池:統一連線字串、盡早 Close、勿動態拼湊。

本手冊涵蓋 ADO.NET 核心類別 90% 以上實務用法,建議收藏備查。

copyright © 萬盛學電腦網 all rights reserved