TableAdapter 組態精靈

發行項
08/21/2008

更新：2007 年 11 月

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

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

執行精靈

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

選擇資料連接

從連接清單中選擇現有的連接，或按一下 [新增連接] 開啟新增/修改連接對話方塊 (一般)，建立資料庫的連接。

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

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

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

將連接字串儲存到應用程式組態檔，可以簡化資料庫連接變更時的應用程式維護程序。在資料庫連接變更時，您可以編輯應用程式組態檔中的連接字串。如此一來，您將不需要編輯原始程式碼及重新編譯應用程式。如需在應用程式組態檔中編輯連接字串的詳細資訊，請參閱 HOW TO：編輯連接字串。

安全性注意事項：
資訊會以純文字儲存在應用程式組態檔。若要降低未經授權存取敏感資訊的可能性，您可能要加密資料。如需詳細資訊，請參閱加密和解密資料。

選擇命令類型

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

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

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

使用 SQL 陳述式

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

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

注意事項：
精靈會提供對 [查詢產生器] (用來建立 SQL 查詢的視覺化工具) 的存取權。請按一下 [查詢產生器] 按鈕，即可將它開啟。如需使用 [查詢產生器] 的詳細資訊，請參閱查詢和檢視表設計工具。

選擇要產生的方法

這個頁面提供選項，為擷取和更新資料，選取精靈應產生的 TableAdapter 方法。

填入 DataTable
建立用來填入資料表的 TableAdapter 預設方法。呼叫這個方法時，將資料表的名稱當做參數傳遞。

您也可以選擇變更 [方法名稱] 方塊中的預設名稱。
傳回 DataTable
建立用來傳回已填入之資料表的 TableAdapter 方法。在特定應用程式中，傳回已填入的資料表會比將資料填入現有資料表，更為理想。

您也可以選擇變更 [方法名稱] 方塊中的預設名稱。

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

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

建立新的預存程序

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

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

注意事項：
精靈會提供對 [查詢產生器] (用來建立 SQL 查詢的視覺化工具) 的存取權。請按一下 [查詢產生器] 按鈕，即可將它開啟。如需使用 [查詢產生器] 的詳細資訊，請參閱查詢和檢視表設計工具，或在此對話方塊中，按 F1。

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

為新的預存程序輸入名稱。

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

注意事項：
特定資料庫的安全性設定和使用權限可決定在資料庫中建立預存程序的能力。例如，如果您沒有在資料庫中建立新預存程序的權限，則無法完成這個選項。

[檢視精靈結果] 頁顯示建立 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 的下列進階選項。如需詳細資訊，請參閱進階 SQL 產生選項對話方塊。

產生 Insert、Update 和 Delete 陳述式

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

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

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

後續步驟

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

加入更多的 TableAdapter。精靈建立一個 TableAdapter。如果您要使用包含多個資料表的資料集，或許會想要在表單或元件中加入更多的 TableAdapter。
將其他查詢加入至 TableAdapter。如需詳細資訊，請參閱 HOW TO：建立 TableAdapter 查詢。
在資料來源視窗中檢視這個資料集，並將項目拖曳至表單上，以建立資料繫結控制項。如需詳細資訊，請參閱顯示資料概觀。

請參閱

共用方式為