IDbCommand 接口

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

表示连接到数据源时执行的 SQL 语句，并由访问关系数据库的 .NET 数据提供程序实现。

public interface class IDbCommand : IDisposable

public interface IDbCommand : IDisposable

type IDbCommand = interface
    interface IDisposable

Public Interface IDbCommand
Implements IDisposable

派生

System.Data.Common.DbCommand

System.Data.OleDb.OleDbCommand

实现

IDisposable

示例

以下示例创建派生类 SqlConnection、 SqlCommand和 SqlDataReader的实例。 该示例通读数据，将其写入控制台。 最后，该示例关闭 ，然后SqlConnection关闭 SqlDataReader。

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}

Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

注解

接口 IDbCommand 使继承类可以实现 Command 类，该类表示在数据源中执行的 SQL 语句。 有关 Command 类的详细信息，请参阅 执行命令。

应用程序不会直接创建 接口的 IDbCommand 实例，而是创建实现 接口的类的 IDbCommand 实例。

实现 IDbCommand 的类必须实现其所有成员，并且通常定义其他成员以添加特定于提供程序的功能。 例如， IDbCommand 接口定义 ExecuteNonQuery 方法。 反过来， SqlCommand 类继承此方法，并定义 ExecuteXmlReader 方法。

实施者说明

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

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

项	描述
PrvCommand ()	初始化 PrvCommand 类的新实例。
PrvCommand (字符串 cmdText)	使用查询的文本初始化 PrvCommand 类的新实例。
PrvCommand (字符串 cmdText、PrvConnection 连接)	使用查询文本和 PrvConnection 初始化 PrvCommand 类的新实例。
PrvCommand (字符串 cmdText、PrvConnection connection、PrvTransaction 事务)	使用查询文本、PrvConnection 和 PrvTransaction 初始化 PrvCommand 类的新实例。

属性

CommandText	获取或设置对数据源运行的文本命令。
CommandTimeout	获取或设置在终止尝试执行命令并生成错误之前的等待时间（以秒为单位）。
CommandType	指示或指定解释 CommandText 属性的方式。
Connection	获取或设置 IDbCommand 的此实例使用的 IDbConnection。
Parameters	获取 IDataParameterCollection。
Transaction	获取或设置要在其中执行 .NET 数据提供程序的 Command 对象的事务。
UpdatedRowSource	获取或设置命令结果在由 DbDataAdapter 的 Update(DataSet) 方法使用时应用于 DataRow 的方式。

方法

Cancel()	尝试取消执行 IDbCommand。
CreateParameter()	创建 IDbDataParameter 对象的新实例。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 IDisposable)
ExecuteNonQuery()	对 .NET 数据提供程序的 Connection 对象执行 SQL 语句，并返回受影响的行数。
ExecuteReader()	对 Connection 执行 CommandText 并生成 IDataReader。
ExecuteReader(CommandBehavior)	对 Connection 执行 CommandText，并使用 CommandBehavior 值之一生成 IDataReader。
ExecuteScalar()	执行查询，并返回由查询返回的结果集中第一行的第一列。 忽略其他列或行。
Prepare()	在数据源上创建准备就绪（或已编译）的命令版本。

另请参阅

• DbDataAdapter
• IDbConnection
• OleDbCommand
• SqlCommand