TableAdapter 組態精靈

發行項
09/14/2015

[TableAdapter 組態精靈] 會建立及編輯 TableAdapter。此精靈會根據您輸入的 SQL 陳述式，或是根據資料庫中的現有預存程序，建立 TableAdapters。精靈也可以根據您輸入至精靈的 SQL 陳述式，建立新的預存程序。

TableAdapter 會連接到資料庫、對資料庫執行查詢或預存程序，以及將查詢或預存程序所傳回的資料填入 DataTable。除了將資料填入現有的資料表，TableAdapter 還可以傳回已填入資料的新資料表。如需詳細資訊，請參閱TableAdapter 概觀。

執行精靈

執行精靈，以建立或編輯 TableAdapter 以及與其關聯的 DataTable。如需詳細資訊，請參閱如何：啟動 TableAdapter 組態精靈。

選擇資料連線

從連接清單中選擇現有連接，或按一下 [新增連線] 建立您資料庫的連接。

完成 [連線屬性] 對話方塊時，[連線詳細資料] 區域會顯示所選取之提供者的唯讀資訊以及連接字串。

將連接字串儲存到應用程式組態檔

選擇 [是，將連接儲存為] ，將連接字串儲存至應用程式組態檔。輸入連接的名稱，或使用提供的預設名稱。

將連接字串儲存至應用程式組態檔，即可簡化資料庫連接變更時的應用程式維護流程。如果資料庫連接變更，您可以編輯應用程式組態檔中的連接字串。這樣一來，您就不需要編輯原始程式碼以及重新編譯您的應用程式。如需編輯應用程式組態檔中連接字串的詳細資訊，請參閱如何：儲存和編輯連接字串。

安全性提示
資訊會以純文字形式儲存在應用程式組態檔中。若要減少未授權存取敏感性資訊的機率，您可能會想要加密資料。如需詳細資訊，請參閱加密和解密資料。

選擇命令類型

選擇要對資料庫執行何種類型的命令。

在 [選擇命令類型] 頁面中，從下列擷取資料庫資料的方法中選取：

使用 SQL 陳述式：可讓您輸入 SQL 陳述式，以從資料庫選取資料。
建立新的預存程序：選取此選項，使精靈根據指定的 SELECT 陳述式，在資料庫建立新的預存程序。
使用現有的預存程序：選取此選項，將資料庫中已存在的預存程序，對應至 TableAdapter 的 SELECT、INSERT、UPDATE 和 DELETE 命令。

使用 SQL 陳述式

本節說明選取 [使用 SQL 陳述式] 選項時，如何完成 [TableAdapter 組態精靈]。

在 [產生 SQL 陳述式] 頁面中，輸入 SQL 陳述式，當執行此 SQL 陳述式時，會將資料填入資料表。

[檢視精靈結果] 頁面會顯示建立 TableAdapter 的結果。若精靈遇到任何問題，則此頁面會提供錯誤資訊。

選擇要產生的方法

此頁面提供選項，選取精靈要為擷取和更新資料產生哪些 TableAdapter 方法。

填入 DataTable
建立填入資料表所使用的 TableAdapter 預設方法。呼叫此方法時，將資料表的名稱做為參數進行傳遞。

您可以選擇性地在 [方法名稱] 方塊中變更預設名稱。
傳回 DataTable
建立傳回已填入的資料表所使用的 TableAdapter 方法。在特定應用程式中，傳回已填入的資料表，會優先於使用資料填入現有資料表。

您可以選擇性地在 [方法名稱] 方塊中變更預設名稱。

建立將更新直接傳送至資料庫的方法
建立將變更寫入到基礎資料庫時所需的 INSERT、UPDATE 和 DELETE 命令。選取此方塊等於將 GenerateDBDirectMethods 屬性設定為 True。

注意事項
當原始 SQL 陳述式未提供足夠的資訊，或者查詢不是可更新的查詢時，就無法使用此選項。例如，在 JOIN 查詢以及傳回單一值 (純量) 的查詢中，即可能會發生此情況。

建立新的預存程序

本節說明在選取 [建立新的預存程序] 選項時，如何完成 [TableAdapter 組態精靈]。

在 [產生預存程序] 頁面中，輸入填入資料表的 SQL 陳述式。這將是 TableAdapter 的 SELECT 陳述式，也是建立選取、更新、插入及刪除資料的預存程序基準。

在 [建立預存程序] 頁面中，執行下列作業：

輸入新預存程序的名稱。

指定是否在基礎資料庫中建立預存程序。

注意事項
可否在資料庫中建立預存程序，是取決於特定資料庫的安全性設定和權限。例如，您沒有在資料庫中建立新預存程序的權限，就無法完成此選項。

[檢視精靈結果] 頁面會顯示建立 TableAdapter 的結果。若精靈遇到任何問題，則此頁面會提供錯誤資訊。

使用現有的預存程序

本節說明選取 [使用現有的預存程序] 選項時，如何完成 [TableAdapter 組態精靈]。

將命令繫結至現有的預存程序

為 TableAdapter 的 SELECT、INSERT、UPDATE 及 DELETE 命令，選取要執行的預存程序。當 TableAdapter 上呼叫關聯的方法時，會執行這些預存程序。例如，呼叫 TableAdapter.Update() 方法時，會執行指派給 Update 命令的預存程序。

從已選取預存程序將參數對應至資料表中對應的資料行。例如，若預存程序接受名稱為 @CompanyName 的參數，並將參數傳至資料表的 CompanyName 資料行，請將 @CompanyName 參數的 [來源資料行] 設為 CompanyName。

注意事項
呼叫您在精靈的下一個步驟中命名的 TableAdapter 方法，就可以執行指派給 SELECT 命令的預存程序。預設值為 Fill，因此執行 SELECT 程序的程式碼通常是 TableAdapter.Fill(tableName)。若您變更預設值 Fill，請將 Fill 替換為指派的名稱，並將 "TableAdapter" 替換成 TableAdapter 的實際名稱 (例如 CustomersTableAdapter)。

進階選項

按一下 [進階選項] 存取 TableAdapter 的下列進階選項。

產生 Insert、Update 和 Delete 陳述式

當您選取此選項時，精靈會根據 [產生 SQL 陳述式] 頁面中定義的 SELECT 陳述式，嘗試產生 INSERT、UPDATE 和 DELETE 陳述式。
使用開放式並行存取

選取此選項可修改 UPDATE 和 DELETE 陳述式，以偵測從最初將個別記錄讀入資料表中以後，是否有修改這些記錄。偵測到並行違規時，會擲出例外狀況。
重新整理 DataTable

選取此選項，以在執行 INSERT 和 UPDATE 陳述式後，重新整理資料表中的資料。

後續步驟

完成精靈之後，便會將 TableAdapter 加入資料集，並且可以在 DataSet 設計工具中對其進行檢視和編輯。您可於其後執行數個步驟。

加入更多的 TableAdapter。精靈只建立一個 TableAdapter。若您想要使用包含多個資料表的資料集，或許會想要將更多 TableAdapter 加入資料集。
將其他查詢加入至 TableAdapter。如需詳細資訊，請參閱如何：建立 TableAdapter 查詢。
在資料來源視窗中檢視此資料集，並將項目拖曳至表單上，以建立資料繫結控制項。如需詳細資訊，請參閱將 Windows Form 控制項繫結至 Visual Studio 中的資料。

請參閱

Share via