逐步解說：使用 TableAdapter DBDirect 方法儲存資料

發行項
06/10/2015

此逐步解說會提供詳細的指示，說明如何使用 TableAdapter 的 DBDirect 方法，直接對資料庫執行 SQL 陳述式。 TableAdapter 的 DBDirect 方法提供五種控制資料庫更新的層級。您可以搭配它們，視應用程式的需求呼叫 Insert、Update 及 Delete 方法，以執行特定 SQL 陳述式及預存程序 (而不是在單一呼叫中執行 UPDATE、INSERT 及 DELETE 陳述式的多載 Update 方法)。

在此逐步解說中，您將了解如何：

建立新的 [Windows 應用程式]。
使用資料來源組態精靈建立和設定資料集。
從 [資料來源] 視窗拖曳項目時，選取要在表單上建立的控制項。如需詳細資訊，請參閱如何：設定從資料來源視窗拖曳時要建立的控制項。
從 [資料來源] 視窗將項目拖曳至表單，以建立資料繫結表單。
加入方法，以直接存取資料庫，並直接對資料庫執行插入、更新及刪除。

必要條件

為了完成此逐步解說，您需要：

Northwind 範例資料庫的存取權。如需詳細資訊，請參閱如何：安裝範例資料庫。

建立 Windows 應用程式

第一步是建立 Windows 應用程式。

建立新的 Windows 專案

在 Visual Studio 中，從 [檔案] 功能表建立新 [專案]。
將專案命名為 TableAdapterDbDirectMethodsWalkthrough。
選取 [Windows 應用程式]，然後按一下 [確定]。如需詳細資訊，請參閱使用 .NET Framework 開發用戶端應用程式。

隨即建立 TableAdapterDbDirectMethodsWalkthrough 專案，並將其加入至方案總管。

從資料庫建立資料來源

此步驟使用 [資料來源組態精靈]，根據 Northwind 範例資料庫中的 Region 資料表，建立資料來源。您必須具有 Northwind 範例資料庫的存取權，才能建立連接。需設定 Northwind 範例資料庫的資訊，請參閱如何：安裝範例資料庫。

若要建立資料來源

按一下 [資料] 功能表上的 [顯示資料來源]。
在 [資料來源] 視窗中，選取 [加入新資料來源]，以啟動 [資料來源組態精靈]。
請選取 [選擇資料來源類型] 頁面上的 [資料庫]，再按 [下一步]。
在 [選擇資料連接] 頁面中，執行下列其中一項工作：
- 如果下拉式清單中有提供 Northwind 範例資料庫的資料連接，請選取這個資料連接。
  
  -或-
- 選取 [新增連接]，啟動 [新增/修改連接] 對話方塊。
如果資料庫需要密碼，請選取選項來加入敏感性資料，然後按一下 [下一步]。
在 [將連接字串儲存到應用程式組態檔] 頁面中按 [下一步]。
在 [選擇您的資料庫物件] 頁面上，展開 [資料表] 節點。
選取 Region 資料表，然後按一下 [完成]。

NorthwindDataSet 會加入專案中，且 Region 資料表會出現在 [資料來源] 視窗中。

將控制項加入表單以顯示資料

從 [資料來源] 視窗將項目拖曳至表單，以建立資料繫結控制項。

在 Windows Form 上建立資料繫結控制項

從 [資料來源] 視窗，將 [Region] 主節點拖曳至表單。

DataGridView 控制項以及巡覽記錄的工具區域 (BindingNavigator) 會出現在表單上。 NorthwindDataSet、RegionTableAdapter、BindingSource 及 BindingNavigator 會顯示在元件匣中。

加入會呼叫個別 TableAdapter DbDirect 方法的按鈕

從工具箱將三個 Button 控制項拖曳至 Form1 (位於 RegionDataGridView 之下)。
在每個按鈕上設定以下的名稱及文字屬性。

名稱

Text

InsertButton

Insert

UpdateButton

更新

DeleteButton

刪除

名稱	Text
InsertButton	Insert
UpdateButton	更新
DeleteButton	刪除

加入程式碼以將新記錄插入至資料庫

按兩下 [InsertButton]，以建立按一下事件的事件處理常式，並在程式碼編輯器中開啟表單。

以下列程式碼取代 InsertButton_Click 事件處理常式：

Private Sub InsertButton_Click() Handles InsertButton.Click

    Dim newRegionID As Integer = 5
    Dim newRegionDescription As String = "NorthEastern" 

    Try
        RegionTableAdapter1.Insert(newRegionID, newRegionDescription)

    Catch ex As Exception
        MessageBox.Show("Insert Failed")
    End Try

    RefreshDataset()
End Sub 


Private Sub RefreshDataset()
    Me.RegionTableAdapter1.Fill(Me.NorthwindDataSet1._Region)
End Sub

private void InsertButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    String newRegionDescription = "NorthEastern";

    try
    {
        regionTableAdapter1.Insert(newRegionID, newRegionDescription);
    }
    catch (Exception ex)
    {
        MessageBox.Show("Insert Failed");
    }
    RefreshDataset();
}


private void RefreshDataset()
{
    this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
}

加入程式碼以更新資料庫中的記錄

按兩下 [UpdateButton]，以建立按一下事件的事件處理常式，並在程式碼編輯器中開啟表單。

以下列程式碼取代 UpdateButton_Click 事件處理常式：

Private Sub UpdateButton_Click() Handles UpdateButton.Click

    Dim newRegionID As Integer = 5

    Try
        RegionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern")

    Catch ex As Exception
        MessageBox.Show("Update Failed")
    End Try

    RefreshDataset()
End Sub

private void UpdateButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;

    try
    {
        regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Update Failed");
    }
    RefreshDataset();
}

加入程式碼以從資料庫刪除記錄

按兩下 [DeleteButto]，以建立按一下事件的事件處理常式，並在程式碼編輯器中開啟表單。

以下列程式碼取代 DeleteButton_Click 事件處理常式：

Private Sub DeleteButton_Click() Handles DeleteButton.Click

    Try
        RegionTableAdapter1.Delete(5, "Updated Region Description")

    Catch ex As Exception
        MessageBox.Show("Delete Failed")
    End Try

    RefreshDataset()
End Sub

private void DeleteButton_Click(object sender, EventArgs e)
{
    try
    {
        regionTableAdapter1.Delete(5, "Updated Region Description");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Delete Failed");
    }
    RefreshDataset();
}

執行應用程式

若要執行應用程式

按 F5 執行應用程式。
按一下 [插入] 按鈕，並確認新記錄是否出現在資料格中。
按一下 [更新] 按鈕，並確認資料格中是否有更新記錄。
按一下 [刪除] 按鈕，並確認是否從資料格刪除記錄。

後續步驟

視應用程式的需求而定，在建立資料繫結表單後，您可能會有幾個想要執行的步驟。一些您可以加強這個逐步解說的部分包括：

將搜尋功能加入至表單。如需詳細資訊，請參閱如何：將參數型查詢加入至 Windows Form 應用程式。
在 [資料來源] 視窗中選取 [以精靈設定資料集]，將其他資料表加入資料集。您可以藉由將關聯節點拖曳至表單，加入顯示關聯資料的控制項。如需詳細資訊，請參閱如何：在 Windows Form 應用程式中顯示相關的資料。

請參閱

共用方式為