C# Builder Personal 版使用 ADO.NET 連接 MSDE 資料庫完整教學

環境與前提

• 工具：C# Builder Personal（不含 Borland Data Providers，僅能用標準 ADO.NET）
• 資料庫：MSDE（隨 C# Builder 安裝）
• 目標：建立連線 → 建立資料表 → 插入資料 → 查詢並顯示於 DataGrid

核心元件與程式碼

1. SqlConnection - 建立連線

拖放 SqlConnection，設定 ConnectionString：

Data Source=.;Initial Catalog=master;Integrated Security=SSPI

按鈕點擊事件測試連線：

private void btnConnect_Click(object sender, EventArgs e)
{
    try
    {
        sqlConnection1.ConnectionString = "Data Source=.;Initial Catalog=master;Integrated Security=SSPI";
        sqlConnection1.Open();
        MessageBox.Show("連線成功！");
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

2. SqlCommand - 執行 SQL 命令

拖放 SqlCommand，設定 Connection 屬性指向 sqlConnection1。純碼建立資料表並插入三筆資料：

private void btnCreateTable_Click(object sender, EventArgs e)
{
    try
    {
        sqlCommand1.Connection = sqlConnection1;
        // 刪除舊表（忽略不存在例外）
        sqlCommand1.CommandText = "DROP TABLE test42";
        try { sqlCommand1.ExecuteNonQuery(); } catch { }

        // 建立新表
        sqlCommand1.CommandText = "CREATE TABLE test42 (id INT NOT NULL, name NVARCHAR(42))";
        sqlCommand1.ExecuteNonQuery();

        // 插入資料
        sqlCommand1.CommandText = "INSERT INTO test42 VALUES (1, 'Bob Swart')";
        sqlCommand1.ExecuteNonQuery();
        sqlCommand1.CommandText = "INSERT INTO test42 VALUES (2, 'Erik Mark Pascal Swart')";
        sqlCommand1.ExecuteNonQuery();
        sqlCommand1.CommandText = "INSERT INTO test42 VALUES (3, 'Natasha Louise Delphine Swart')";
        sqlCommand1.ExecuteNonQuery();

        MessageBox.Show("資料表建立並插入完成！");
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

ExecuteNonQuery 用於不傳回資料列的 SQL（DDL、INSERT、UPDATE、DELETE）。

3. SqlDataAdapter + DataSet + DataGrid - 查詢與顯示

拖放三個元件：SqlDataAdapter、DataSet、DataGrid。

private void btnQuery_Click(object sender, EventArgs e)
{
    try
    {
        sqlDataAdapter1.SelectCommand.Connection = sqlConnection1;
        sqlDataAdapter1.SelectCommand.CommandText = "SELECT * FROM test42";
        sqlDataAdapter1.Fill(dataSet1, "MyTable42");
        dataGrid1.DataSource = dataSet1;
        dataGrid1.DataMember = "MyTable42";
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

快速重現步驟（RAD 模式）

1. 新增 C# 專案
2. 放 SqlConnection，設定 ConnectionString
3. 放 SqlDataAdapter，設定 SelectCommand.Connection 與 CommandText
4. 放 DataGrid，套用 Auto Format
5. 在 Form_Load 撰寫填充與繫結碼：

private void Form_Load(object sender, EventArgs e)
{
    try
    {
        DataSet ds = new DataSet();
        sqlDataAdapter1.Fill(ds, "MyTable42");
        dataGrid1.DataSource = ds;
        dataGrid1.DataMember = "MyTable42";
        sqlConnection1.Close(); // 明確關閉
    }
    catch (Exception ex) { MessageBox.Show(ex.Message); }
}

關鍵提醒

• 連線會由 Fill 自動開啟，但必須明確呼叫 Close() 釋放。
• Personal 版雖無 Borland 提供者，標準 System.Data.SqlClient 完全足應付 MSDE/SQL Server 開發。