TableAdapter 查詢組態精靈

發行項
08/12/2011

[TableAdapter 查詢組態精靈] 可協助您建立和編輯其他查詢，並將它們加入至 TableAdapter。 TableAdapter 查詢是任何有效的 SQL 查詢或預存程序，其傳回的資料之結構描述會與 TableAdapter 的相關資料表相同 (或是會傳回純量值)。完成精靈之後，方法會加入至 TableAdapter，呼叫此方法時，會執行查詢 (例如，CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle"))。

執行精靈

將查詢拖曳至 [DataSet 設計工具]，或設定現有查詢 (列在第一個查詢底下的任何查詢)。

TableAdapter 中的第一個查詢是 TableAdapter 的主查詢。編輯這個主查詢時，會開啟 [TableAdapter 組態精靈] 並且編輯 TableAdapter 資料表的結構描述。列在主查詢底下的所有查詢都是其他查詢，而且會使用 [TableAdapter 查詢組態精靈] 加以設定。如需執行精靈的詳細資訊，請參閱 HOW TO：啟動 TableAdapter 查詢組態精靈。

選擇資料連接

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

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

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

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

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

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

使用 SQL 陳述式

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

選擇查詢類型

精靈會根據應用程式需求，建立多個查詢類型。您可以選擇傳回多個資料列 (資料表) 的 SELECT 查詢，或傳回純量值 (單一值，例如 Count 或 Sum) 的 SELECT 查詢。

請在 [選擇查詢類型] 頁面上，從可用的查詢清單中選取要建立的查詢類型。

注意事項
建立 INSERT、UPDATE 或 DELETE 陳述式並不會取代 TableAdapter 的命令 (這些命令會在呼叫 TableAdapter 的 Update 方法時使用)。例如，選取 UPDATE 做為查詢類型時，將會以您稍後在精靈中指定的名稱，建立新查詢。您可以呼叫 TableAdapter 的這個具名方法，執行此查詢。呼叫 TableAdapter 的 Update 方法，將會執行設定原始 TableAdapter 時所建立的陳述式。

建立 INSERT、UPDATE 或 DELETE 陳述式並不會取代 TableAdapter 的命令 (這些命令會在呼叫 TableAdapter 的 Update 方法時使用)。例如，選取 UPDATE 做為查詢類型時，將會以您稍後在精靈中指定的名稱，建立新查詢。您可以呼叫 TableAdapter 的這個具名方法，執行此查詢。呼叫 TableAdapter 的 Update 方法，將會執行設定原始 TableAdapter 時所建立的陳述式。

指定 SQL <查詢類型> 陳述式

在 [指定 SQL 陳述式] 頁面上，輸入呼叫查詢時要執行的 SQL 陳述式。

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

選擇要產生的方法

此頁面提供許多選項，讓您選取精靈針對查詢產生的方法。

填入 DataTable
建立填入資料表的方法。呼叫這個方法將傳回的資料填入資料表時，會傳遞資料表名稱當做參數。

您也可以選擇變更 [方法名稱] 方塊中的預設名稱。提供有意義的名稱，有助於在程式碼中使用這個查詢。
傳回 DataTable
建立傳回已填入資料表的方法。在特定應用程式中，傳回已填入的資料表會比將資料填入現有資料表，更為理想。

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

選擇函式名稱

輸入函式的名稱。建立 TableAdapter 查詢時，會以此處所提供的名稱將方法加入至 TableAdapter。呼叫這個方法，即可執行查詢。提供有意義的名稱，有助於在程式碼中使用這個查詢。

注意事項
建立新的預存程序時，系統會要求您提供兩個名稱。第一個名稱是資料庫中建立的預存程序名稱；第二個名稱是 TableAdapter 上的方法名稱，呼叫這個方法時，會執行此預存程序。

建立新的預存程序

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

在 [產生預存程序] 頁面上，輸入呼叫預存程序時要執行的 SQL 陳述式。

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

在 [建立預存程序] 頁中，執行下列作業：
1. 為新的預存程序輸入名稱。
2. 指定是否要在基礎資料庫中建立預存程序。
  
  注意事項
  
  特定資料庫的安全性設定，決定在資料庫中建立預存程序的能力。
[檢視精靈結果] 頁面會顯示建立 TableAdapter 查詢的結果。如果精靈遇到問題，則這個頁面會提供錯誤資訊。

注意事項
特定資料庫的安全性設定，決定在資料庫中建立預存程序的能力。

使用現有的預存程序

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

在精靈的 [選擇現有的預存程序] 頁面上，從下拉式清單中選取現有的預存程序。

此時會顯示所選預存程序的 [參數] 和 [結果]，供您參考。
按一下 [下一步]。

選擇預存程序所傳回資料的形式

選取的預存程序所傳回資料的類型，決定精靈如何建立 TableAdapter 方法。

選取這個查詢所傳回資料的類型。

選取 [表格式資料] 會開啟 [選擇要產生的方法] 頁面 (如本說明網頁所述)，可讓您指定方法類型、方法名稱，以及要建立的分頁支援。
選取 [單一值] 會建立傳回單一值的具型別方法。這個選項會開啟 [選擇函式名稱] 頁面 (如本說明網頁所述)。
選取 [沒有值] 則會建立具型別方法，執行不會傳回資料的預存程序。這個選項會開啟 [選擇函式名稱] 頁面 (如本說明網頁所述)。

檢視精靈結果

[檢視精靈結果] 頁面會顯示建立 TableAdapter 查詢的結果。如果精靈遇到問題，這個頁面上會顯示詳細資料。

請參閱

Share via