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

發行項
08/21/2008

更新：2007 年 11 月

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

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

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

建立新的 [Windows 應用程式] 專案。
使用資料來源組態精靈建立和設定應用程式的資料來源。
在資料來源視窗中設定項目的控制項。如需詳細資訊，請參閱 HOW TO：設定從資料來源視窗拖曳時要建立的控制項。
從 [資料來源] 視窗將項目拖曳至表單上，即可建立資料繫結控制項。
修改資料集的一些資料錄
加入程式碼，將資料集中的更新資料送回資料庫。

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

必要條件

若要完成這個逐步解說，您必須要有：

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

建立 Windows 應用程式

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

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

從 [檔案] 功能表中，建立新專案。
將專案命名為 UpdateSingleTableWalkthrough。
請選取 [Windows 應用程式]，並按 [確定]。如需詳細資訊，請參閱建立 Windows 架構的應用程式。

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

建立資料來源

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

若要建立資料來源

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

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

設定要建立的控制項

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

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

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

建立資料繫結表單

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

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

從 [資料來源] 視窗，將主要 [Customers] 節點拖曳至 [Form1]。

具有描述性標籤的資料繫結控制項以及用於巡覽資料錄的工具區域 (BindingNavigator) 會出現在表單上。NorthwindDataSet、CustomersTableAdapter、BindingSource 和 BindingNavigator 則會出現在元件匣中。

修改程式碼來更新資料庫

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

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

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

取代事件處理常式中的程式碼，加入一些錯誤處理。程式碼外觀應為：

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");
}