共用方式為


逐步解說:儲存資料至資料庫 (單一資料表)

在應用程式的開發過程中,其中一個最常見的案例是在 Windows 應用程式的表單上顯示資料、編輯資料,以及將更新資料傳送回資料庫。 這個逐步解說會建立一個簡單表單,以便在個別控制項中顯示來自單一資料表的資料。 您可以編輯控制項中的資料,並將變更儲存回資料庫。 這個範例會使用 Northwind 範例資料庫的 Customers 資料表。

您可以將應用程式的資料儲存回資料庫,只要呼叫 TableAdapter 的 Update 方法即可。 當您從 [資料來源] 視窗拖曳項目時,會自動針對第一個拖曳到表單上的資料表加入要儲存資料的程式碼。 任何加入到表單上的其他資料表則需要手動加入儲存資料所需的任何程式碼。 如需儲存一個以上的資料表的資料之詳細資訊,請參閱逐步解說:儲存資料至資料庫 (多個資料表)

逐步解說將說明的工作包括:

注意事項注意事項

根據您目前使用的設定或版本,您所看到的對話方塊與功能表指令可能會與 [說明] 中描述的不同。 若要變更設定,請從 [工具] 功能表中選取 [匯入和匯出設定]。 如需詳細資訊,請參閱 使用設定

必要條件

若要完成這個逐步解說,您必須要有:

建立 Windows 應用程式

第一個步驟是建立 [Windows 應用程式]。 在這個步驟中,指定專案名稱是選擇性的動作,但因為我們稍後要儲存它,所以會為它命名。

若要建立新的 Windows 應用程式專案

  1. 從 [檔案] 功能表中,建立新專案。

  2. 將專案命名為 UpdateSingleTableWalkthrough。

  3. 請選取 [Windows 應用程式],並按 [確定]。 如需詳細資訊,請參閱建立 Windows 架構的應用程式

    隨即建立 UpdateSingleTableWalkthrough 專案並將其加入至 [方案總管]。

建立資料來源

這個步驟使用 [資料來源組態精靈],從 Northwind 資料庫建立資料來源。 您必須可以存取 Northwind 範例資料庫,才能完成精靈。 如需設定 Northwind 範例資料庫的詳細資訊,請參閱 HOW TO:安裝範例資料庫

若要建立資料來源

  1. 按一下 [資料] 功能表上的 [顯示資料來源]。

  2. 在 [資料來源] 視窗中,按一下 [加入新資料來源],啟動 [資料來源組態精靈]。

  3. 請選取 [選擇資料來源類型] 頁面上的 [資料庫],再按 [下一步]。

  4. 在 [選擇資料連接] 頁面上,執行下列其中一項動作:

    • 如果下拉式清單中有提供 Northwind 範例資料庫的資料連接,請選取這個資料連接。

      -或-

    • 選取 [新增連接],開啟 [新增/修改連接] 對話方塊。 如需詳細資訊,請參閱新增/修改連接對話方塊 (一般)

  5. 如果資料庫需要密碼,請選取選項來加入敏感性資料,然後按一下 [下一步]。

  6. 按一下 [將連接字串儲存到應用程式組態檔] 頁面上的 [下一步]。

  7. 在 [選擇您的資料庫物件] 頁面上,展開 [資料表] 節點。

  8. 選取 [Customers] 資料表,再按 [完成]。

    [NorthwindDataSet] 會加入至專案,而且 Customers 資料表會出現在 [資料來源] 視窗中。

設定要建立的控制項

在這個逐步解說中,資料將設為 [詳細資料] 配置,也就是在個別控制項中顯示資料,而不是預設的 DataGridView 配置。

在資料來源視窗中設定項目的控制項

  1. 在 [資料來源] 視窗中,展開 [Customers] 節點。

  2. 從 [客戶] 節點的下拉式清單中選取 [詳細資料],將 [客戶] 資料表的控制項變更為個別控制項。 如需詳細資訊,請參閱 HOW TO:設定從資料來源視窗拖曳時要建立的控制項

建立資料繫結表單

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

若要在表單上建立資料繫結控制項

修改程式碼來更新資料庫

您可以呼叫 CustomersTableAdapter 的 Update 方法來更新資料庫。 根據預設,BindingNavigator 的 [儲存] 按鈕之事件處理常式會加入至表單的程式碼,將更新傳送至資料庫。 這個程序將修改程式碼,藉由包裝 try-catch 區塊中的更新呼叫來加入錯誤處理。 您可以修改程式碼,使其符合應用程式的需求。

若要將更新邏輯加入至應用程式

  1. 按兩下 BindingNavigator 上的 [儲存] 按鈕,在開啟的 [程式碼編輯器] 中顯示 bindingNavigatorSaveItem_Click 事件處理常式。

  2. 取代事件處理常式中的程式碼,加入一些錯誤處理。 程式碼外觀應為:

    Try
        Me.Validate()
        Me.CustomersBindingSource.EndEdit()
        Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
        MsgBox("Update successful")
    
    Catch ex As Exception
        MsgBox("Update failed")
    End Try
    
    try
    {
        this.Validate();
        this.customersBindingSource.EndEdit();
        this.customersTableAdapter.Update(this.northwindDataSet.Customers);
        MessageBox.Show("Update successful");
    }
    catch (System.Exception ex)
    {
        MessageBox.Show("Update failed");
    }
    

測試應用程式

若要測試應用程式

  1. 按 F5。

  2. 變更一或多個資料錄的資料。

  3. 按下 [儲存] 按鈕。

  4. 檢查資料庫的值,確認變更已儲存。

後續步驟

根據應用程式的需求而定,您在建立資料繫結的 Windows 應用程式表單後可能還會想執行幾個步驟。 您可以對這個逐步解說進行加強的部分包括:

請參閱

概念

資料應用程式開發的新功能

將 Windows Form 控制項繫結至 Visual Studio 中的資料

將控制項繫結至 Visual Studio 中的資料

其他資源

資料逐步解說

連接至 Visual Studio 中的資料

準備您的應用程式以接收資料

將資料擷取至您的應用程式中

在您的應用程式中編輯資料

驗證資料

儲存資料