.NET 連接 Oracle 資料庫完整實戰：環境配置、連線字串與查詢範例

2. 連線字串最佳實踐

// app.config / web.config
<connectionStrings>
  <add name="OracleConn"
       connectionString="Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL)));User Id=myuser;Password=mypwd;Pooling=true;Min Pool Size=1;Max Pool Size=100;Connection Lifetime=120;"
       providerName="Oracle.ManagedDataAccess.Client" />
</connectionStrings>

關鍵參數說明

3. 核心資料存取類別實作

using System;
using System.Data;
using Oracle.ManagedDataAccess.Client;
using System.Configuration;

public static class OracleHelper
{
    private static readonly string ConnStr = ConfigurationManager.ConnectionStrings["OracleConn"].ConnectionString;

    // 執行查詢回傳 DataTable
    public static DataTable ExecuteQuery(string sql, params OracleParameter[] parameters)
    {
        using (var conn = new OracleConnection(ConnStr))
        using (var cmd = new OracleCommand(sql, conn))
        {
            if (parameters != null) cmd.Parameters.AddRange(parameters);
            using (var adapter = new OracleDataAdapter(cmd))
            {
                var dt = new DataTable();
                adapter.Fill(dt);
                return dt;
            }
        }
    }

    // 執行非查詢 (INSERT/UPDATE/DELETE/存儲過程)
    public static int ExecuteNonQuery(string sql, params OracleParameter[] parameters)
    {
        using (var conn = new OracleConnection(ConnStr))
        using (var cmd = new OracleCommand(sql, conn))
        {
            if (parameters != null) cmd.Parameters.AddRange(parameters);
            conn.Open();
            return cmd.ExecuteNonQuery();
        }
    }

    // 執行純量查詢
    public static object ExecuteScalar(string sql, params OracleParameter[] parameters)
    {
        using (var conn = new OracleConnection(ConnStr))
        using (var cmd = new OracleCommand(sql, conn))
        {
            if (parameters != null) cmd.Parameters.AddRange(parameters);
            conn.Open();
            return cmd.ExecuteScalar();
        }
    }

    // 呼叫存儲過程回傳游標 (OracleRefCursor)
    public static DataTable ExecuteProcCursor(string procName, params OracleParameter[] parameters)
    {
        using (var conn = new OracleConnection(ConnStr))
        using (var cmd = new OracleCommand(procName, conn))
        {
            cmd.CommandType = CommandType.StoredProcedure;
            if (parameters != null) cmd.Parameters.AddRange(parameters);
            using (var adapter = new OracleDataAdapter(cmd))
            {
                var dt = new DataTable();
                adapter.Fill(dt);
                return dt;
            }
        }
    }
}

4. Windows Forms 整合範例

登入表單

public partial class LoginForm : Form
{
    private void btnLogin_Click(object sender, EventArgs e)
    {
        // 動態建構連線字串 (實務建議從加密設定檔讀取)
        var builder = new OracleConnectionStringBuilder
        {
            DataSource = txtDataSource.Text.Trim(),  // EZCONNECT 字串
            UserID = txtUser.Text.Trim(),
            Password = txtPwd.Text,
            Pooling = true
        };

        using (var conn = new OracleConnection(builder.ConnectionString))
        {
            try
            {
                conn.Open();
                MessageBox.Show("連線成功！");
                this.Hide();
                new MainForm(builder.ConnectionString).Show();
            }
            catch (OracleException ex)
            {
                MessageBox.Show($"連線失敗: {ex.Message}\n錯誤碼: {ex.Number}");
            }
        }
    }
}

主表單 - DataGridView 綁定查詢結果

public partial class MainForm : Form
{
    private readonly string _connStr;

    public MainForm(string connStr) { InitializeComponent(); _connStr = connStr; }

    private void MainForm_Load(object sender, EventArgs e)
    {
        LoadUserData();
    }

    private void LoadUserData()
    {
        const string sql = "SELECT user_id, user_name, email, created_date FROM app_users WHERE status = :status ORDER BY created_date DESC";
        var param = new OracleParameter("status", OracleDbType.Varchar2, "A", ParameterDirection.Input);

        try
        {
            using (var conn = new OracleConnection(_connStr))
            using (var cmd = new OracleCommand(sql, conn))
            using (var adapter = new OracleDataAdapter(cmd))
            {
                cmd.Parameters.Add(param);
                var dt = new DataTable();
                adapter.Fill(dt);
                dataGridView1.DataSource = dt;
                dataGridView1.AutoSizeColumnsMode = DataGridViewAutoSizeColumnsMode.AllCells;
            }
        }
        catch (Exception ex)
        {
            MessageBox.Show($"查詢失敗: {ex.Message}");
        }
    }
}

5. 常見問題排查清單

1. ORA-12154: TNS:could not resolve the connect identifier specified
   → 使用 EZCONNECT 完整描述繞過 tnsnames.ora，或確認 tnsnames.ora 路徑在 TNS_ADMIN 環境變數中。
2. ORA-12514: TNS:listener does not currently know of service requested
   → 檢查 Service Name/SID 拼寫，確認 Listener 已註冊該服務 (lsnrctl status)。
3. ORA-28040: No matching authentication protocol
   → 12c+ 預設停用舊式密碼驗證，需在 sqlnet.ora 設定 SQLNET.ALLOWED_LOGON_VERSION_SERVER=11 或升級客戶端驅動。
4. 中文亂碼
   → 連線字串加 Unicode=True，資料庫字符集為 AL32UTF8，NLS_LANG 環境變數設為 TRADITIONAL CHINESE_TAIWAN.ZHT16MSWIN950 或 AMERICAN_AMERICA.AL32UTF8。
5. 連線洩漏導致 ORA-00020: maximum number of processes exceeded
   → 嚴格使用 using 區塊確保連線釋回池，調整 Max Pool Size 與資料庫 PROCESSES 參數。

6. 進階主題

• 非同步操作：.NET 4.5+ 使用 OpenAsync()、ExecuteReaderAsync() 避免阻塞 UI 執行緒。
• 批次作業：OracleCommand.ArrayBindCount 搭配參數陣列執行批次 INSERT/UPDATE，效能優於迴圈。
• 依賴注入：ASP.NET Core 中註冊 OracleConnection 為 Scoped 服務，配合 IOptions<OracleSettings> 管理設定。

總結

採用 Oracle.ManagedDataAccess、EZCONNECT 連線字串、參數化查詢與連線池配置，能構建穩定、高效、可維護的 .NET-Oracle 資料存取層。嚴格遵循 using 模式管理連線生命週期，善用非同步 API 提升回應性，並建立完善的錯誤碼對應與監控機制，是企業級應用的關鍵成功因素。