共用方式為


HOW TO:手動建立及設定資料配接器

更新:2007 年 11 月

您可以在不使用精靈的情況下建立資料配接器。無論您如何建立配接器,都可以對它進行組態變更。

注意事項:

在舊版本的 Visual Studio 中,資料配接器用於應用程式和資料庫之間的通訊。雖然資料配接器仍然是 .NET Framework 資料提供者 (ADO.NET)的主要元件,但 TableAdapter 是設計工具產生的元件,它可以簡化在應用程式和資料庫之間的資料移動程序。如需使用 TableAdapter 的詳細資訊,請參閱 TableAdapter 概觀

注意事項:

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

根據預設,在 Visual Studio 中,已經停用了對資料配接器的設計階段支援。若要支援資料配接器,您必須將資料配接器加入到 [工具箱] 中,如底下的第一個程序中所述。

若要將資料配接器、連接和命令加入到工具箱

  1. 以滑鼠右鍵按一下 [工具箱],然後選擇 [ 選擇項目]。

  2. 從 [選擇工具箱項目] 對話方塊的 [.NET Framework 元件] 索引標籤中,選取您想要加入的項目。例如,若要使用 .NET Framework Data Provider for SQL Server,請選取 [SqlDataAdapter]、[SqlConnection] 和 [SqlCommand]。

  3. 按一下 [確定],即可將所選項目加入到 [工具箱] 中。

若要手動建立資料配接器

  1. 請確定您使用的表單或元件具有可用的連接物件。如需加入獨立連接的詳細資訊,請參閱建立連接 (ADO.NET)

  2. 從 [工具箱] 的 [資料] 索引標籤,將 OleDbDataAdapterSqlDataAdapterOdbcDataAdapterOracleDataAdapter 物件拖曳到設計介面中。

    設計工具會將配接器的執行個體加入到表單或元件,接著啟動 [資料配接器組態精靈]。

  3. 關閉精靈。

若要手動設定資料配接器

  1. 選取配接器,接著在 [屬性] 視窗中設定用來讀取和更新資料的命令。您必須設定 SelectCommand 物件。如果要使用配接器來更新資料來源,您也必須設定 UpdateCommand、DeleteCommand 和 InsertCommand 物件。

    針對每個命令物件,設定下列屬性。

    屬性

    說明

    ActiveConnection

    設定來參考連接物件。您可以從 [屬性] 視窗的 ActiveConnection 屬性來建立連接物件。通常每個命令物件都會參考相同的連接物件,但您可以視應用程式的需要來為每個命令使用不同的連接。

    CommandText

    SQL 陳述式的文字或預存程序的名稱。

    針對某些提供者,您可以在 CommandText 屬性中包含多個陳述式或預存程序名稱,並以分號 (;) 區隔。陳述式或程序會循序執行。適用的情況像是在 UPDATE 或 INSERT 陳述式之後,發出 SELECT 陳述式來取回重新整理的資料錄以及任何自動產生的值 (例如預設或自動增量值)。

    CommandType

    指示應如何解譯 CommandText 屬性的值:

    • Text:命令是 SQL 陳述式。

    • StoredProcedure:命令是預存程序的參考。

    • TableDirect:該文字不是命令,而是資料表的名稱。

    參數

    Parameter 型別物件的集合,讓您設定來將值傳遞至命令。在 SelectCommand 物件中,您只能在命令包含參數替代符號的情況下建立參數集合。UpdateCommand、InsertCommand 和 DeleteCommand 物件一定需要參數。如需詳細資訊,請參閱 HOW TO:為資料配接器設定參數

  2. 如果您不想在資料來源和資料集使用相同的資料行名稱,請變更對應。MissingMappingAction 屬性的預設值 (亦即 Passthrough) 會自動在資料來源和資料集當中產生相同的名稱。如需詳細資訊,請參閱 HOW TO:將資料來源的資料行對應至資料集資料表的資料行

  3. 從 [資料] 功能表中,選擇 [產生資料集]。

    秘訣

    如果您看不到 [資料] 功能表,請在表單或元件設計工具的任何地方按一下滑鼠;只有焦點在設計工具時才會顯示此功能表。

  4. 如果您要檢視資料配接器將會如何填滿資料集,請預覽結果。如需詳細資訊,請參閱 HOW TO:預覽資料配接器結果

請參閱

概念

從 DataAdapter 填入 DataSet (ADO.NET)

資料的新功能

使用 Visual Studio 建立資料應用程式

其他資源

DataAdapter 和 DataReader (ADO.NET)

建立資料配接器

資料逐步解說

ADO.NET