C# 連接 Oracle 資料庫三大經典模式完整代碼範例

使用 System.Data.OracleClient 連接 Oracle，涵蓋 **DataSet 離線模式**、**DataReader 串流模式**、**Command 執行非查詢** 三大核心場景，代碼開箱即用。

前置準備

// 1. 專案引用 System.Data.OracleClient.dll
// 2. 頂部引入命名空間
using System.Data.OracleClient;

模式一：DataSet 離線填充（適合綁定 UI、多次遍歷）

// 建立連接
OracleConnection oraCon = new OracleConnection("user id=112;data source=wmatech;password=112");
// 建立適配器
OracleDataAdapter oraDap = new OracleDataAdapter("select * from actor", oraCon);
// 填充 DataSet
DataSet ds = new DataSet();
oraDap.Fill(ds);
// 取首個 DataTable
DataTable dt = ds.Tables[0];
int rowCount = dt.Rows.Count;
// 綁定 DataGrid
DataGrid1.DataSource = dt;
DataGrid1.DataBind();

• Fill 會自動開啟/關閉連接，無需手動 Open/Close。
• 適合資料量中等、需游標式操作或綁定控件的場景。

模式二：DataReader 串流讀取（高性能、唯讀、順向）

OracleConnection oraCon = new OracleConnection("user id=112;data source=wmatech;password=112");
OracleCommand oraCmd = new OracleCommand("select * from actor", oraCon);
oraCon.Open();
OracleDataReader oraRD = oraCmd.ExecuteReader();
string html = "";
while (oraRD.Read()) {
    html += oraRD[0] + "   " + oraRD[1] + "   " + oraRD[2] + "
";
}
oraRD.Close();   // 必須關閉 Reader
oraCon.Close();  // 釋放連接
Response.Write(html);

• ExecuteReader 返回 OracleDataReader，**必須显式關閉** Close() 才能釋放連接池資源。
• 單向、唯讀、記憶體佔用極低，適合大數據量逐行處理。

模式三：Command 執行 DML（Insert/Update/Delete）

OracleConnection oraCon = new OracleConnection("user id=112;data source=wmatech;password=112");
OracleCommand oraCmd = new OracleCommand("update actor set name='123453' where id='admin'", oraCon);
oraCon.Open();
int affectedRows = oraCmd.ExecuteNonQuery();  // 返回影響行數
Response.Write(affectedRows.ToString());
oraCon.Close();

• ExecuteNonQuery 用於非查詢 SQL，返回受影響行數（int）。
• 參數化查詢建議使用 oraCmd.Parameters.Add 防注入、提升效能。

進階：交易控制

OracleConnection oraCon = new OracleConnection(connStr);
oraCon.Open();
OracleTransaction tx = oraCon.BeginTransaction();
try {
    OracleCommand cmd = oraCon.CreateCommand();
    cmd.Transaction = tx;
    cmd.CommandText = "update ..."; cmd.ExecuteNonQuery();
    cmd.CommandText = "insert ..."; cmd.ExecuteNonQuery();
    tx.Commit();
} catch {
    tx.Rollback(); throw;
} finally {
    oraCon.Close();
}

OracleTransaction 確保多條 SQL 原子性，**生產環境批量寫入必用**。

連接字串關鍵屬性

掌握三大模式與交易控制，即可應對 90% 以上的 Oracle 存取場景。

1. 上一篇文章： C# 實作 IEnumerable 與 IEnumerator：讓自訂類別支援 foreach 迭代
2. 下一篇文章： C# 登錄表持久化用戶設定：極簡泛型封裝與單元測試驗證

關於C#

房貸計算器數學原理深度解析：等本息 vs 等本金 利息總額推導與比較

一、等本息法月繳額推導 定義：每月繳納固定金額，包含本金與利

WPF/Silverlight 遊戲開發教程 (8)：完美實現 A* 尋路動態動畫 — PathFinderFast、關鍵幀平滑銜接、軌跡視覺化

前置準備：角色與障礙物 Ellipse player = n

C# 動態繪製數學函數圖形：運算式解析、座標映射與 WinForms 即時渲染完整實作

在 WinForms 應用程式中實現**使用者輸入數學運算式

C# WinForms 編輯視窗框架 BaseEditForm：新增/修改統一、驗證、實體綁定完整實作

設計目標 統一「新增」與「修改」邏輯： 單一視窗類別處