HOW TO:為資料配接器設定參數
更新:2007 年 11 月
在多數情況下,資料配接器的 Command 物件 (SelectCommand、InsertCommand、UpdateCommand 和 DeleteCommand) 參考需有參數的 SQL 陳述式或預存程序。如果您已使用資料配接器組態精靈來建立配接器,則會自動為您設定這些命令的參數。但您可能想要手動設定參數,或稍微變更現有參數集合。
注意事項: |
---|
在舊版本的 Visual Studio 中,資料配接器用於應用程式和資料庫之間的通訊。雖然資料配接器仍然是 .NET Framework 資料提供者 (ADO.NET)的主要元件,但 TableAdapter 是設計工具產生的元件,它可以簡化在應用程式和資料庫之間的資料移動程序。如需使用 TableAdapter 的詳細資訊,請參閱 TableAdapter 概觀。 |
秘訣 |
---|
若要在變更 SQL 陳述式之後設定命令的參數,您可以選擇 [查詢產生器] 中的 [重新產生此命令的參數集合] 選項。 |
注意事項: |
---|
根據目前使用的設定與版本,您所看到的對話方塊與功能表命令可能會與 [說明] 中所描述的不同。如果要變更設定,請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊,請參閱 Visual Studio 設定。 |
若要設定資料配接器的參數
建立資料配接器。如需詳細資訊,請參閱建立資料配接器。
在表單或元件設計工具中,選取資料配接器,再開啟 [屬性] 視窗。
展開您要設定其參數的命令物件 (例如,UpdateCommand),接著在 Parameters 屬性中按一下省略 (...) 按鈕,開啟 [參數集合編輯器] 視窗。
若要建立新的參數物件,請按一下 [加入]。
按一下 [排序] 之下的箭頭來移動新參數,將這個參數置於集合中的正確索引位置。
若要設定參數屬性,請選取 [成員] 清單中的參數,接著使用右邊的屬性方格。下表列出您經常設定的屬性。
屬性
說明
SourceColumn
將用於讀取參數值之資料集資料表中的資料行名稱。這個屬性是與在 UPDATE、INSERT 或 DELETE 陳述式 (或相等的預存程序) 中填滿值的參數一起使用。
SourceVersion
如果參數值是透過 SourceColumn 屬性衍生,SourceVersion 會指定應將哪個資料集資料錄的版本使用為參數值來源。
Original:從資料庫讀取時的資料行值。當您需要變更之前的資料行值時,請使用這個選項。例如,當主索引鍵已經變更,而您卻需要舊的索引鍵才能在資料庫中找到資料錄時。
Current:資料錄已更新後的資料行值。通常是會寫入資料庫的值。
Default:如果沒有明確提供的值,則會用來設定資料行的值。
值
為參數設定的明確值。通常是在執行階段設定這個屬性,而不是在設計階段進行靜態設定。
若兩者皆已設定,Value 屬性會優先於 SourceColumn 屬性。
NamedParameter
布林值,指出參數是否對應到變數 (通常格式為 @parametername),或是否對應到預留位置 (通常是一個問號)。如果您使用 SqlConnection 物件和具名參數,請將這個屬性設定為 true。
DBType、Precision、Scale 和 Size
參數值的原生資料 (Native Data) 型別資訊 (在資料存放區當中)。參數值會與您所指定的型別相互轉換。
Direction
是否會將參數值傳遞至命令或傳回的規格。
Input:會傳遞給命令的值。此為預設值。
Output:會從預存程序傳遞回來的值 (不適用於 SQL 陳述式)。
InputOutput:會傳遞至預存程序並傳回的值,且通常是經修改的值。
ReturnValue:明確的傳回值。根據預設,傳回值會是參數集合中的第一個項目 (索引值為零)。
ParameterName
您可以集合中參數為參考的名稱,而不需以索引值參考。雖然不是必要,但建議使用參數名稱以方便維護。
請按一下 [確定],關閉 [參數集合編輯器] 視窗。
重複步驟 3 到 7 為其他命令物件設定參數。