IDbCommand 接口

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

程序集:

System.Data.dll

程序集:

netstandard.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.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

实现

IDisposable

示例

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

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语句。 有关命令类的详细信息，请参阅 “执行命令”。

应用程序不会直接创建接口的 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 连接、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