ASP.NET 存取 Oracle 資料庫核心類別與實戰範例：System.Data.OracleClient 完整操作指南

Microsoft .NET Framework Data Provider for Oracle (`System.Data.OracleClient`) 為 .NET 應用程式提供原生、高效能的 Oracle 存取能力，API 設計與 `SqlClient`、`OleDb` 高度一致。本文系統介紹核心四大類別、特殊資料型別對應、參數化查詢、交易處理、完整 CRUD 範例，助您快速上手。

系統需求與安裝

• .NET Framework 1.0/1.1/2.0/3.5/4.x (內建於 4.0 以前，4.0 起標記過時)
• MDAC 2.6+ (建議 2.7/2.8)
• Oracle Client 8.1.7+ (8i R3 / 9i / 10g / 11g / 12c / 19c)
• 安裝 `oracle_net.msi` 或複製 `System.Data.OracleClient.dll` 至 Bin 目錄 (不含分散式交易時)

核心命名空間與四大類別

System.Data.OracleClient
  ├─ OracleConnection     : 連線管理、連線池、交易啟始
  ├─ OracleCommand        : SQL/預存程序執行、參數集合
  ├─ OracleDataReader     : 唯讀、順向、資料流讀取
  └─ OracleDataAdapter    : 離線架構、DataSet 填充、更新回寫

Oracle 特殊資料型別對應表

完整 CRUD 範例 (C#)

1. 建立測試資料表

CREATE TABLE OracleTypesTable (
    MyVarchar2 VARCHAR2(3000),
    MyNumber   NUMBER(28,4) PRIMARY KEY,
    MyDate     DATE,
    MyRaw      RAW(255)
);

INSERT INTO OracleTypesTable 
VALUES ('test', 4, TO_DATE('2000-01-11 12:54:01','YYYY-MM-DD HH24:MI:SS'), HEXTORAW('0001020304'));

2. 查詢資料 (DataReader 模式)

using (var conn = new OracleConnection(connStr))
using (var cmd = new OracleCommand("SELECT * FROM OracleTypesTable WHERE MyNumber = :num", conn))
{
    cmd.Parameters.Add(":num", OracleType.Number).Value = 4;
    conn.Open();
    using (var reader = cmd.ExecuteReader())
    {
        while (reader.Read())
        {
            Console.WriteLine($"Varchar2: {reader.GetString(0)}");
            Console.WriteLine($"Number: {reader.GetDecimal(1)}");
            Console.WriteLine($"Date: {reader.GetDateTime(2)}");
            Console.WriteLine($"Raw: {BitConverter.ToString((byte[])reader.GetValue(3))}");
        }
    }
}

3. 參數化新增/修改/刪除

// Insert
string sql = @"INSERT INTO OracleTypesTable (MyVarchar2, MyNumber, MyDate, MyRaw) 
               VALUES (:v, :n, :d, :r)";
using (var cmd = new OracleCommand(sql, conn))
{
    cmd.Parameters.Add(":v", OracleType.VarChar).Value = "new test";
    cmd.Parameters.Add(":n", OracleType.Number).Value = 5;
    cmd.Parameters.Add(":d", OracleType.DateTime).Value = DateTime.Now;
    cmd.Parameters.Add(":r", OracleType.Raw).Value = new byte[] { 0x05, 0x06, 0x07 };
    conn.Open();
    int rows = cmd.ExecuteNonQuery();
}

// Update (使用位置參數 :1, :2... 或命名參數)
string updSql = "UPDATE OracleTypesTable SET MyVarchar2 = :v WHERE MyNumber = :n";
// Delete
string delSql = "DELETE FROM OracleTypesTable WHERE MyNumber = :n";

4. 交易處理

using (var conn = new OracleConnection(connStr))
{
    conn.Open();
    using (var tx = conn.BeginTransaction(IsolationLevel.ReadCommitted))
    {
        try
        {
            // 多筆命令共用交易
            new OracleCommand("INSERT ...", conn, tx).ExecuteNonQuery();
            new OracleCommand("UPDATE ...", conn, tx).ExecuteNonQuery();
            tx.Commit();
        }
        catch
        {
            tx.Rollback();
            throw;
        }
    }
}

5. DataAdapter 離線模式 (DataSet 双向同步)

var adapter = new OracleDataAdapter("SELECT * FROM OracleTypesTable", conn);
var builder = new OracleCommandBuilder(adapter); // 自動產生 Insert/Update/Delete 命令

var ds = new DataSet();
adapter.Fill(ds, "OracleTypesTable");

// 修改資料
ds.Tables["OracleTypesTable"].Rows[0]["MyVarchar2"] = "modified";

// 寫回資料庫
adapter.Update(ds, "OracleTypesTable");

常見陷阱與最佳實踐

遷移至現代 ODP.NET Managed / EF Core

// NuGet: Oracle.ManagedDataAccess.Core
using Oracle.ManagedDataAccess.Client; // 命名空間相同，類別名相同

// NuGet: Oracle.EntityFrameworkCore
// DbContext 配置
options.UseOracle(connectionString);
// LINQ 查詢、遷移、追蹤、影子屬性... 完整 EF Core 體驗

• **無需安裝 Oracle Client**：單一 Managed DLL、xcopy 部署
• **支援 .NET Core / 5 / 6 / 7 / 8** 跨平台 (Linux Docker 容器)
• **效能更優**：原生非同步、陣列綁定、Statement Cache、FAN 高可用
• **官方長期支援**；`System.Data.OracleClient` 已停止更新

掌握 `System.Data.OracleClient` 核心類別與參數化模式，是維護 Legacy 專案的必備技能；但**所有新專案請直接採用 ODP.NET Managed + EF Core**，享受現代化開發體驗與長期支援保障。