IDataParameter 接口
表示 Command 对象的参数,也可以表示该对象到 DataSet 列的映射；并且是由访问数据源的 .NET Framework 数据提供程序实现的。
**命名空间:**System.Data
**程序集:**System.Data（在 system.data.dll 中）
语法
声明
Public Interface IDataParameter
用法
Dim instance As IDataParameter
public interface IDataParameter
public interface class IDataParameter
public interface IDataParameter
public interface IDataParameter
备注
IDataParameter 接口允许继承类实现 Parameter 类，表示 Command 对象的参数。有关 Parameter 类的更多信息，请参见 将存储过程用于命令。有关实现 .NET Framework 数据提供程序的更多信息，请参见 Implementing a .NET Framework Data Provider。
应用程序不直接创建 IDataParameter 接口的实例，而是创建继承 IDataParameter 的类的实例。
继承 IDataParameter 的类必须实现继承的成员，并通常会定义附加成员来添加提供程序特定的功能。例如，IDataParameter 接口定义 DbType 属性。然后，OleDbParameter 类继承此属性，还定义 OleDbType 属性。
给实现者的说明 为提高 .NET Framework 数据提供程序之间的一致性，请命名 Prv Parameter 窗体中的继承类，其中 Prv 是给予特定 .NET Framework 数据提供程序命名空间中的所有类的统一前缀。例如，Sql 是 System.Data.SqlClient 命名空间中 SqlCommand 类的前缀。 在从 IDataParameter 接口继承时，应实现下列构造函数：
项 |
说明 |
|---|---|
PrvParameter() |
初始化 Parameter 类的新实例。 |
PrvParameter(string name, PrvDbType dataType) |
使用参数名和数据类型初始化 Parameter 类的新实例。 |
PrvParameter(string name, object value) |
使用参数名和作为 Parameter 值的对象初始化 Parameter 类的新实例。 |
PrvParameter(string name, PrvDbType dataType, int size) |
使用参数名、数据类型和宽度初始化 Parameter 类的新实例。 |
PrvParameter(string name, PrvDbType dataType, int size, string srcColumn) |
使用参数名、数据类型、宽度和源列名称初始化 DbParameter 类的新实例。 |
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value) |
使用参数名称、数据类型、宽度、源列名称、参数方向、数值精度和其他属性初始化 OleDbParameter 类的新实例。 |
示例
下面的示例通过 SqlDataAdapter 内的 SqlParameterCollection 集合，创建派生类 SqlParameter 的多个实例。这些参数用于从数据源中选择数据并将数据放在 DataSet 中。此示例假定已经用适当的架构、命令和连接创建了 DataSet 和 SqlDataAdapter。
Public Sub AddSqlParameters()
' ...
' create categoriesDataSet and categoriesAdapter
' ...
categoriesAdapter.SelectCommand.Parameters.Add( _
"@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
categoriesAdapter.SelectCommand.Parameters.Add( _
"@SerialNum", SqlDbType.Int).Value = 239
categoriesAdapter.Fill(categoriesDataSet)
End Sub
public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...
categoriesAdapter.SelectCommand.Parameters.Add(
"@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
categoriesAdapter.SelectCommand.Parameters.Add(
"@SerialNum", SqlDbType.Int).Value = 239;
categoriesAdapter.Fill(categoriesDataSet);
}
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0