HOW TO：為資料配接器設定參數
更新：2007 年 11 月
在多數情況下，資料配接器的 Command 物件 (SelectCommand、InsertCommand、UpdateCommand 和 DeleteCommand) 參考需有參數的 SQL 陳述式或預存程序。如果您已使用資料配接器組態精靈來建立配接器，則會自動為您設定這些命令的參數。但您可能想要手動設定參數，或稍微變更現有參數集合。
.gif "注意事項") 注意事項： |
|---|
在舊版本的 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 為其他命令物件設定參數。