共用方式為


參數集合編輯器

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

編輯參數集合

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

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

  1. SelectCommandUpdateCommandInsertCommandDeleteCommand 屬性開啟節點。

  2. 編輯 [參數] 屬性,開啟 [參數集合編輯器]。

注意事項注意事項

如果您使用類似 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
    從集合中刪除選取的參數。

請參閱

參考

SqlParameter

概念

將 Windows Form 控制項繫結至 Visual Studio 中的資料

將控制項繫結至 Visual Studio 中的資料

其他資源

TableAdapter

連接至 Visual Studio 中的資料

準備您的應用程式以接收資料

將資料擷取至您的應用程式中

在您的應用程式中編輯資料

驗證資料

儲存資料