參數集合編輯器
可讓您建立及設定參數 (OleDbParameter、SqlParameter、OdbcParameter 和 OracleParameter 物件),這些參數與 TableAdapters 和資料配接器中的 SQL 陳述式或預存程序 (Stored Procedure) 相關聯。
編輯參數集合
在您使用 [屬性] 視窗,於 DataSet 設計工具中設定 TableAdapter,或於表單或元件上設定資料配接器時,會顯示 [參數集合編輯器]。
在 [DataSet 設計工具] 介面上選取 TableAdapter,然後在 [屬性] 視窗中選取 [參數] 屬性,以開啟 [參數集合編輯器]。
為 SelectCommand、UpdateCommand、InsertCommand 和 DeleteCommand 屬性開啟節點。
編輯 [參數] 屬性,開啟 [參數集合編輯器]。
![]() |
---|
如果您使用類似 TableAdapter 組態精靈或 資料配接器組態精靈的資料設計工具來設定配接器,則會自動設定此配接器的參數。 |
參數命名
這些命令中的陳述式或預存程序,可使用參數替代符號 (Placeholder) 定義。
如果您使用 OleDbDataAdapter 物件,則陳述式會使用問號做為替代符號,其結果如下所示:
Select * From Customers Where City = ?
如果您使用 SqlDataAdapter 物件,則使用具名參數的陳述式可能如下:
Select * From Customers Where City = @City
如果您使用 OracleDataAdapter 物件,則使用 Oracle 具名參數的陳述式可能如下:
SELECT * FROM Customers WHERE CustomerID = :pCustomerID
![]() |
---|
對於 Oracle 而言,在 SQL 陳述式或預存程序中使用具名參數時,必須在參數名稱前加上冒號 (:)。 然而,在程式碼的其他地方參考具名參數時 (例如,呼叫 Add 方法時),不可在具名參數之前加上冒號 (:)。 因為資料提供者會自動加上冒號。 |
加入參數
命令的 Parameters 集合 (例如 Parameters) 包括了參數物件的清單,這些物件可用來在執行階段將值傳給陳述式或預存程序。 因此,每個參數值都有一個需要傳送給某命令的參數物件。
編輯器分割為兩個窗格。 在左窗格中可加入和移除參數,而在右窗格中可為獨立參數設定屬性,其中:
ParameterName 屬性,可用來參考程式碼中的參數。
注意事項
SqlDataAdapter 類別需要具名參數,因此在 SqlParameter 物件中,名稱前一定要加上 "@"。
SourceColumn 屬性,可識別參數值來自於資料錄中的何處。 此值可於更新時使用;資料配接器會將特定資料行的值傳送到 Update 命令。
SourceVersion 屬性,可與 SourceColumn 屬性一起搭配使用。 如果資料錄在資料集中已變更,則多個資料錄複本皆可使用,其中包括原始值 (讀取自資料來源) 和目前的值 (變更後)。 在指定某資料行值做為參數傳送時,您可選取要傳送哪兩個值。 一般而言,原始值可於 WHERE 子句中做為參數之用,以識別資料庫中的資料錄,以及在 SET 或 VALUES 子句中使用的目前值。
Value 屬性是傳遞為參數的明確常值。 設定此屬性會覆寫 SourceColumn 屬性;這兩個屬性互斥。
使用者介面項目清單
加入
在集合中建立新參數。 根據預設,資料表會命名為 Parametern,其中 n 為序號。 您可於屬性格線中設定其 ParameterName 屬性,以便重新命名資料表。注意事項
[OleDbParameter 集合編輯器] 不會檢查您是否為命令建立正確的參數數目,也不檢查是否為正確的型別。
參數根據位置配合陳述式或命令中的參數替代符號。 因此,請確定參數在集合中正確排列。
Remove
從集合中刪除選取的參數。
請參閱
參考
概念
將 Windows Form 控制項繫結至 Visual Studio 中的資料