IDbCommand 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示连接到数据源时执行的 SQL 语句,并由访问关系数据库的 .NET 数据提供程序实现。
public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
interface IDisposable
Public Interface IDbCommand
Implements 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 | |
Transaction |
获取或设置要在其中执行 .NET 数据提供程序的 |
UpdatedRowSource |
获取或设置命令结果在由 DbDataAdapter 的 Update(DataSet) 方法使用时应用于 DataRow 的方式。 |
方法
Cancel() |
尝试取消执行 IDbCommand。 |
CreateParameter() |
创建 IDbDataParameter 对象的新实例。 |
Dispose() |
执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 IDisposable) |
ExecuteNonQuery() |
对 .NET 数据提供程序的 |
ExecuteReader() |
对 Connection 执行 CommandText 并生成 IDataReader。 |
ExecuteReader(CommandBehavior) |
对 Connection 执行 CommandText,并使用 CommandBehavior 值之一生成 IDataReader。 |
ExecuteScalar() |
执行查询,并返回由查询返回的结果集中第一行的第一列。 忽略其他列或行。 |
Prepare() |
在数据源上创建准备就绪(或已编译)的命令版本。 |