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 / Password | SQL 驗證帳密 | sa / P@ssw0rd |
| Integrated Security / Trusted_Connection | Windows 整合驗證 | true / SSPI |
| Connect Timeout | 連線逾時秒數 | 30 |
| Pooling / Min Pool Size / Max Pool Size | 連線池控制 | true / 0 / 100 |
| MultipleActiveResultSets (MARS) | 單連線多結果集 | true |
// 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;"
// 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() | SqlDataReader | SELECT、多列/多欄 |
ExecuteNonQuery() | int (影響列數) | INSERT/UPDATE/DELETE、DDL |
ExecuteScalar() | object (第一列第一欄) | COUNT(*), SUM(), 單一值 |
ExecuteXmlReader() | XmlReader | FOR XML 查詢 |
// 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());
// 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
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 填充
// 自動產生 Insert/Update/Delete 命令 (需 SelectCommand 有主鍵)
var cb = new SqlCommandBuilder(da);
da.Update(dataSet, "Products"); // 根據 RowState 自動執行對應命令
將 Sql 前綴改為 OleDb,連線字串對應即可,API 幾乎相同。
cmd.Parameters.Add("@p", SqlDbType.Int).Value = 1;。CommandBehavior.SequentialAccess + GetBytes/GetChars 串流。本手冊涵蓋 ADO.NET 核心類別 90% 以上實務用法,建議收藏備查。