Share via


TableAdapter 查詢組態精靈

 

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

執行精靈

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

TableAdapter 中的第一個查詢是 TableAdapter 的主要查詢。 編輯此主要查詢會開啟 [TableAdapter 組態精靈] 並編輯 TableAdapter 資料表的結構描述。 主要查詢下方所列都是額外的查詢,並且是使用 [TableAdapter 查詢組態精靈] 所設定。 如需執行精靈的詳細資訊,請參閱如何:啟動 TableAdapter 查詢組態精靈

選擇資料連接

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

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

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

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

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

重要

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

使用 SQL 陳述式

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

選擇查詢類型

此精靈會建立數種類型的查詢 (視您應用程式的需求而定)。 您可以選擇傳回數列資料 (資料表) 的 SELECT 查詢,還是傳回純量值 (單一值,如 CountSum) 的 SELECT 查詢。

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

注意

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

指定 SQL <Query Type> 陳述式

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

提示

此精靈提供對查詢產生器 (用於建立 SQL 查詢的視覺工具) 的存取權。 若要開啟它,請按一下 [查詢產生器] 按鈕。

選擇要產生的方法

此頁面所提供的選項用於選取精靈針對查詢所產生的方法。

填入 DataTable
建立用於填入資料表的方法。 呼叫此方法將所傳回的資料填入資料表時,您可以將資料表名稱傳遞為參數。

您可以選擇性地在 [方法名稱] 方塊中變更預設名稱。 在程式碼中使用此查詢時,提供有意義的名稱十分有用。

傳回 DataTable
建立用於傳回已填入之資料表的方法。 在特定應用程式中,傳回已填入的資料表,會優先於使用資料填入現有資料表。

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

選擇函式名稱

輸入函式的名稱。 建立 TableAdapter 查詢,會將方法加入至具有這裡所提供名稱的 TableAdapter。 呼叫此方法以執行查詢。 在程式碼中使用此查詢時,提供有意義的名稱十分有用。

注意

建立新的預存程序時,系統會要求您提供兩個名稱。 第一個名稱是在資料庫中建立的預存程序名稱;第二個名稱是 TableAdapter 上執行所呼叫預存程序的方法名稱。

建立新的預存程序

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

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

    注意

    此精靈提供對查詢產生器 (用於建立 SQL 查詢的視覺工具) 的存取權。 若要開啟它,請按一下 [查詢產生器] 按鈕。

  2. 在 [建立預存程序] 頁面中,執行下列作業:

    1. 輸入新預存程序的名稱。

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

      注意

      在資料庫中建立預存程序的能力是透過特定資料庫的安全性設定所決定。

    [檢視精靈結果] 頁面顯示建立 TableAdapter 查詢的結果。 如果精靈發生問題,則此頁面會提供錯誤資訊。

使用現有的預存程序

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

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

    即會顯示所選取預存程序的 [參數] 和 [結果],以供參考。

  2. 按 [下一步]。

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

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

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

  • 選取 [表格式資料] 會開啟 [選擇要產生的方法] 頁面 (在此 [說明] 頁面上稍前所述),讓您可以指定方法類型、方法名稱以及要建立的分頁支援。

  • 選取 [單一值] ,會建立傳回單一值的具類型方法。 此選項會開啟 [選擇函式名稱] 頁面 (在此 [說明] 頁面上稍早所述)。

  • 選取 [沒有值],會建立執行預存程序且預期不會傳回任何資料的具類型方法。 此選項會開啟 [選擇函式名稱] 頁面 (在此 [說明] 頁面上稍早所述)。

檢視精靈結果

[檢視精靈結果] 頁面顯示建立 TableAdapter 查詢的結果。 如果精靈發生問題,則會在此頁面上顯示詳細資料。

請參閱

TableAdapter 概觀
如何:編輯 TableAdapter 查詢
資料逐步解說
將 Windows Form 控制項繫結至 Visual Studio 中的資料
Visual Studio 資料應用程式的概觀
連接至 Visual Studio 中的資料
準備您的應用程式以接收資料
將資料擷取至您的應用程式中
將控制項繫結至 Visual Studio 中的資料
在您的應用程式中編輯資料
驗證資料
儲存資料