參數集合編輯器

更新：2007 年 11 月

可讓您建立及設定參數 (OleDbParameter、SqlParameter、OdbcParameter 和 OracleParameter 物件)，這些參數與 TableAdapters 和資料配接器中的 SQL 陳述式或預存程序 (Stored Procedure) 相關聯。

編輯參數集合

在您使用 [屬性] 視窗，於 DataSet 設計工具中設定 TableAdapter，或於表單或元件上設定資料配接器時，會顯示 [參數集合編輯器]。

在 [DataSet 設計工具] 介面上選取 TableAdapter，然後在 [屬性] 視窗中選取 [參數] 屬性，以開啟 [參數集合編輯器]。

注意事項：
如果您使用類似 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 屬性；這兩個屬性互斥。

注意事項：
SqlDataAdapter 類別需要具名參數，因此在 SqlParameter 物件中，名稱前一定要加上 "@"。

如需參數的詳細資訊，請參閱資料配接器命令中的參數。

注意事項：
[OleDbParameter 集合編輯器] 不會檢查您是否為命令建立正確的參數數目，也不檢查是否為正確的型別。