IDbCommand 接口

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

**命名空间:**System.Data
**程序集:**System.Data（在 system.data.dll 中）

语法

声明
Public Interface IDbCommand
    Inherits IDisposable
用法
Dim instance As IDbCommand

public interface IDbCommand : IDisposable

public interface class IDbCommand : IDisposable

public interface IDbCommand extends IDisposable

public interface IDbCommand extends IDisposable

备注

IDbCommand 接口允许继承类实现 Command 类，该类表示在数据源处执行的 SQL 语句。有关 Command 类的更多信息，请参见 执行命令。有关实现 .NET Framework 数据提供程序的更多信息，请参见 Implementing a .NET Framework Data Provider。

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

继承 IDbCommand 的类必须实现所有继承成员，且通常定义更多的成员，以添加提供程序特定的功能。例如，IDbCommand 接口定义 ExecuteNonQuery 方法。然后，SqlCommand 类继承此方法，还定义 ExecuteXmlReader 方法。

给实现者的说明 为提高 .NET Framework 数据提供程序之间的一致性，请命名 PrvClassname 窗体中的继承类，其中 Prv 是给予特定 .NET Framework 数据提供程序命名空间中的所有类的统一前缀。例如，Sql 是 System.Data.SqlClient 命名空间中 SqlCommand 类的前缀。 在从 IDbCommand 接口继承时，应实现下列构造函数：

项	说明
PrvCommand()	初始化 PrvCommand 类的新实例。
PrvCommand(string cmdText)	使用查询文本初始化 PrvCommand 类的新实例。
PrvCommand(string cmdText, PrvConnection connection)	使用查询文本和 PrvConnection 初始化 PrvCommand 类的新实例。
PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction)	使用查询文本、PrvConnection 和 PrvTransaction 初始化 PrvCommand 类的新实例。

示例

下面的示例创建派生类 SqlConnection、SqlCommand 和 SqlDataReader 的实例。该示例读取所有数据，并将其写到控制台。最后，该示例先关闭 SqlDataReader，然后关闭 SqlConnection。

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

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();
        SqlDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
        finally
        {
            // Always call Close when done reading.
            reader.Close();
        }
    }
}

平台

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

请参见

参考

IDbCommand 成员
System.Data 命名空间
DbDataAdapter
IDbConnection
OleDbCommand
SqlCommand