参数集合编辑器

更新：2007 年 11 月

允许您创建和配置与 TableAdapters 和数据适配器中的 SQL 语句或存储过程关联的参数（OleDbParameter、SqlParameter、OdbcParameter 和 OracleParameter 对象）。

编辑参数集合

当使用数据集设计器中的“属性”窗口配置 TableAdapter，或配置窗体或组件的数据适配器时，会显示“参数集合编辑器”。

在“数据集设计器”图面上选择一个 TableAdapter，并在“属性”窗口中选择“参数”属性以打开“参数集合编辑器”。

说明：
如果使用数据设计工具（如 TableAdapter 配置向导）或数据适配器配置向导配置适配器，则适配器的参数将自动配置。

这些命令中的语句或存储过程可以用参数占位符定义。

如果使用 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 属性，该属性标识参数值来自数据记录中的何处。此值在更新期间使用；数据适配器将某一特定列的值传递到更新命令中。
SourceVersion 属性，该属性与 SourceColumn 属性一起使用。如果数据集中的某个记录发生更改，则可以使用该记录的多个副本，包括原始值（即从数据源读取的值）和当前值（即更改后的值）。当指定一个作为参数传递的列值时，可以从这两个值中选择一个来传递。通常情况下，原始值用作 WHERE 子句中的参数以标识数据库中的记录，而当前值则用于 SET 或 VALUES 子句中。
Value 属性，该属性是作为参数传递的明确值。设置此属性将重写 SourceColumn 属性；这两个属性是互斥的。

说明：
SqlDataAdapter 类需要命名参数，因此在 SqlParameter 对象中，名称必须始终带“@”前缀。

有关参数的更多信息，请参见数据适配器命令中的参数。

说明：
“OleDbParameter 集合编辑器”不检查为命令创建的参数的数目是否正确，也不检查这些参数的类型是否正确。