IDataParameter 接口

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

表示 Command 对象的参数，也可以表示其到 DataSet 列的映射；并由访问数据源的 .NET 数据提供程序实现。

public interface class IDataParameter

public interface IDataParameter

type IDataParameter = interface

Public Interface IDataParameter

派生

System.Data.Common.DbParameter

System.Data.EntityClient.EntityParameter

System.Data.IDbDataParameter

System.Data.Odbc.OdbcParameter

System.Data.OleDb.OleDbParameter

System.Data.OracleClient.OracleParameter

示例

以下示例通过 SqlParameterCollection 中的 SqlDataAdapter集合创建派生类 SqlParameter的多个实例。 这些参数用于从数据源中选择数据，并将数据置于 中 DataSet。 此示例假定 DataSet 已使用适当的架构、命令和连接创建了 和 SqlDataAdapter 。

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);
}

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

注解

接口 IDataParameter 允许继承类实现 Parameter 类，该类表示 Command 对象的参数。 有关参数类的详细信息，请参阅 配置参数和参数数据类型。

应用程序不会直接创建 接口的 IDataParameter 实例，而是创建继承 的类的 IDataParameter实例。

继承 IDataParameter 的类必须实现继承的成员，并且通常定义其他成员以添加特定于提供程序的功能。 例如， IDataParameter 接口定义 DbType 属性。 类反过来 OleDbParameter 会继承此属性，并定义 OleDbType 属性。

实施者说明

若要促进.NET Framework数据提供程序之间的一致性，请以参数形式Prv命名继承类，其中 Prv 是给定给特定.NET Framework数据提供程序命名空间中所有类的统一前缀。 例如， Sql 是 命名空间中 类的SqlCommandSystem.Data.SqlClient前缀。

从 IDataParameter 接口继承时，应实现以下构造函数：

项	描述
PrvParameter ()	初始化 Parameter 类的新实例。
PrvParameter (字符串名称，PrvDbType dataType)	使用参数名称和数据类型初始化 Parameter 类的新实例。
PrvParameter (字符串名称、对象值)	使用参数名称和作为 Parameter 值的对象初始化 Parameter 类的新实例。
PrvParameter (字符串名称、PrvDbType dataType、int 大小)	使用参数名称、数据类型和宽度初始化 Parameter 类的新实例。
PrvParameter (字符串名称、PrvDbType dataType、int size、字符串 srcColumn)	使用参数名称、数据类型、宽度和源列名初始化 DbParameter 类的新实例。
PrvParameter (string parameterName， PrvDbType dbType， int size， ParameterDirection direction， Boolean isNullable， Byte precision， Byte scale， string srcColumn， DataRowVersion srcVersion， object value)	使用参数名称、数据类型、宽度、源列名、参数方向、数值精度和其他属性初始化 类的新实例 OleDbParameter 。

属性

DbType	获取或设置参数的 DbType。
Direction	获取或设置一个值，该值指示参数是只可输入的参数、只可输出的参数、双向参数还是存储过程返回值参数。
IsNullable	获取一个值，该值指示参数是否接受 null 值。
ParameterName	获取或设置 IDataParameter 的名称。
SourceColumn	获取或设置映射到 DataSet 并且用于加载或返回 Value 的源列的名称。
SourceVersion	获取或设置要在加载 Value 时使用的 DataRowVersion。
Value	获取或设置参数的值。