萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

C# 使用 OleDb 連接操作 Access 資料庫 (CRUD) 完整範例

使用 `System.Data.OleDb` 搭配 `Microsoft.Jet.OLEDB.4.0` (`.mdb`) 或 `Microsoft.ACE.OLEDB.12.0` (`.accdb`) 提供者,實現 Access 資料庫的連接、查詢、新增、修改、刪除完整操作。

連接字串設定

<connectionStrings>
  <!-- Access 2003 (.mdb) -->
  <add name="Access2003" connectionString="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=|DataDirectory|\App_Data\Database.mdb" />
  <!-- Access 2007+ (.accdb) -->
  <add name="Access2007" connectionString="Provider=Microsoft.ACE.OLEDB.12.0;Data Source=|DataDirectory|\App_Data\Database.accdb;Persist Security Info=False" />
</connectionStrings>

註:使用 ACE 提供者需安裝 Access Database Engine,並注意 32/64 位元相容。

封裝資料存取類別

using System;
using System.Data;
using System.Data.OleDb;
using System.Configuration;

public class AccessHelper
{
    private readonly string _connStr;

    public AccessHelper(string connStringName = "Access2007")
    {
        _connStr = ConfigurationManager.ConnectionStrings[connStringName].ConnectionString;
        // 支援 |DataDirectory| 替換
        if (_connStr.Contains("|DataDirectory|"))
        {
            string dataDir = AppDomain.CurrentDomain.GetData("DataDirectory")?.ToString() 
                           ?? AppDomain.CurrentDomain.BaseDirectory + "App_Data\\";
            _connStr = _connStr.Replace("|DataDirectory|", dataDir);
        }
    }

    private OleDbConnection GetConnection() => new OleDbConnection(_connStr);

    /// 執行查詢,回傳 DataTable
    public DataTable ExecuteQuery(string sql, params OleDbParameter[] parameters)
    {
        using (var conn = GetConnection())
        using (var cmd = new OleDbCommand(sql, conn))
        {
            if (parameters != null) cmd.Parameters.AddRange(parameters);
            using (var adapter = new OleDbDataAdapter(cmd))
            {
                var dt = new DataTable();
                adapter.Fill(dt);
                return dt;
            }
        }
    }

    /// 執行非查詢 (INSERT/UPDATE/DELETE),回傳影響列數
    public int ExecuteNonQuery(string sql, params OleDbParameter[] parameters)
    {
        using (var conn = GetConnection())
        using (var cmd = new OleDbCommand(sql, conn))
        {
            if (parameters != null) cmd.Parameters.AddRange(parameters);
            conn.Open();
            return cmd.ExecuteNonQuery();
        }
    }

    /// 執行 Scalar 查詢 (單一值)
    public object ExecuteScalar(string sql, params OleDbParameter[] parameters)
    {
        using (var conn = GetConnection())
        using (var cmd = new OleDbCommand(sql, conn))
        {
            if (parameters != null) cmd.Parameters.AddRange(parameters);
            conn.Open();
            return cmd.ExecuteScalar();
        }
    }
}

CRUD 實作範例

public class ProductRepository
{
    private readonly AccessHelper _db = new AccessHelper();

    // 查詢所有
    public DataTable GetAll() => _db.ExecuteQuery("SELECT ProductID, ProductName, Price FROM Products ORDER BY ProductID");

    // 依 ID 查詢
    public DataTable GetById(int id) => _db.ExecuteQuery(
        "SELECT * FROM Products WHERE ProductID = ?", 
        new OleDbParameter("@id", id));

    // 新增 (Access 使用 ? 參數佔位符,順序必須與 SQL 參數順序一致)
    public int Insert(string name, decimal price) => _db.ExecuteNonQuery(
        "INSERT INTO Products (ProductName, Price) VALUES (?, ?)",
        new OleDbParameter("@name", name),
        new OleDbParameter("@price", price));

    // 修改
    public int Update(int id, string name, decimal price) => _db.ExecuteNonQuery(
        "UPDATE Products SET ProductName = ?, Price = ? WHERE ProductID = ?",
        new OleDbParameter("@name", name),
        new OleDbParameter("@price", price),
        new OleDbParameter("@id", id));

    // 刪除
    public int Delete(int id) => _db.ExecuteNonQuery(
        "DELETE FROM Products WHERE ProductID = ?",
        new OleDbParameter("@id", id));
}

WinForms / Web Forms 呼叫範例

var repo = new ProductRepository();

// 綁定 GridView / DataGridView
dataGridView1.DataSource = repo.GetAll();

// 新增
btnAdd.Click += (s, e) => {
    repo.Insert(txtName.Text, decimal.Parse(txtPrice.Text));
    dataGridView1.DataSource = repo.GetAll(); // 重新綁定
};

// 刪除 (假設 DataGridView 選取列)
btnDelete.Click += (s, e) => {
    if (dataGridView1.CurrentRow != null)
    {
        int id = (int)dataGridView1.CurrentRow.Cells["ProductID"].Value;
        repo.Delete(id);
        dataGridView1.DataSource = repo.GetAll();
    }
};

關鍵注意事項

項目說明
參數佔位符Access/OleDB 使用 ? 而非 @param,參數順序必須與 SQL 中 ? 出現順序完全一致
關鍵字轉義欄位/資料表名稱若為保留字 (如 `Date`, `Order`, `Key`),需用方括號包裹:[Date], [Order]
連接釋放務必使用 `using` 區塊確保連接關閉,Access 連接數有限 (預設 255),洩漏易導致「無法開啟資料庫」錯誤
並行存取Access 為檔案型資料庫,高併發寫入易鎖死/損毀,僅適合單機/低併發/桌面應用
32/64 位元IIS 應用程式集區「啟用 32 位元應用程式」需與安裝的 Access Engine 位元數一致

現代化建議

  • 新專案優先考慮 SQLite (單檔、無需安裝、支援並發、EF Core 完整支援)
  • 或 SQL Server Express LocalDB (真正的關聯式資料庫引擎,開發/測試/小型生產適用)
  • 若必須用 Access,封裝 Repository 模式隔離存取邏輯,未來遷移成本較低。

OleDb 操作 Access 基礎且實用,掌握參數順序、連接釋放、關鍵字轉義三大關鍵,即可穩定完成 CRUD 操作。

copyright © 萬盛學電腦網 all rights reserved