HOW TO:手動建立及設定資料配接器
更新:2007 年 11 月
您可以在不使用精靈的情況下建立資料配接器。無論您如何建立配接器,都可以對它進行組態變更。
![]() |
---|
在舊版本的 Visual Studio 中,資料配接器用於應用程式和資料庫之間的通訊。雖然資料配接器仍然是 .NET Framework 資料提供者 (ADO.NET)的主要元件,但 TableAdapter 是設計工具產生的元件,它可以簡化在應用程式和資料庫之間的資料移動程序。如需使用 TableAdapter 的詳細資訊,請參閱 TableAdapter 概觀。 |
![]() |
---|
根據目前使用的設定與版本,您所看到的對話方塊與功能表命令可能會與 [說明] 中所描述的不同。若要變更設定,請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊,請參閱 Visual Studio 設定。 |
根據預設,在 Visual Studio 中,已經停用了對資料配接器的設計階段支援。若要支援資料配接器,您必須將資料配接器加入到 [工具箱] 中,如底下的第一個程序中所述。
若要將資料配接器、連接和命令加入到工具箱
以滑鼠右鍵按一下 [工具箱],然後選擇 [ 選擇項目]。
從 [選擇工具箱項目] 對話方塊的 [.NET Framework 元件] 索引標籤中,選取您想要加入的項目。例如,若要使用 .NET Framework Data Provider for SQL Server,請選取 [SqlDataAdapter]、[SqlConnection] 和 [SqlCommand]。
按一下 [確定],即可將所選項目加入到 [工具箱] 中。
若要手動建立資料配接器
請確定您使用的表單或元件具有可用的連接物件。如需加入獨立連接的詳細資訊,請參閱建立連接 (ADO.NET)。
從 [工具箱] 的 [資料] 索引標籤,將 OleDbDataAdapter、SqlDataAdapter、OdbcDataAdapter 或 OracleDataAdapter 物件拖曳到設計介面中。
設計工具會將配接器的執行個體加入到表單或元件,接著啟動 [資料配接器組態精靈]。
關閉精靈。
若要手動設定資料配接器
選取配接器,接著在 [屬性] 視窗中設定用來讀取和更新資料的命令。您必須設定 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:為資料配接器設定參數。
如果您不想在資料來源和資料集使用相同的資料行名稱,請變更對應。MissingMappingAction 屬性的預設值 (亦即 Passthrough) 會自動在資料來源和資料集當中產生相同的名稱。如需詳細資訊,請參閱 HOW TO:將資料來源的資料行對應至資料集資料表的資料行。
從 [資料] 功能表中,選擇 [產生資料集]。
秘訣
如果您看不到 [資料] 功能表,請在表單或元件設計工具的任何地方按一下滑鼠;只有焦點在設計工具時才會顯示此功能表。
如果您要檢視資料配接器將會如何填滿資料集,請預覽結果。如需詳細資訊,請參閱 HOW TO:預覽資料配接器結果。
請參閱
概念
從 DataAdapter 填入 DataSet (ADO.NET)