OleDbCommand 类

定义

命名空间:

System.Data.OleDb

程序集:

System.Data.OleDb.dll

包:

System.Data.OleDb v11.0.0-preview.2.26159.112

Source:

OleDbCommand.cs

表示要针对数据源执行的 SQL 语句或存储过程。

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

继承

Object

DbCommand

OleDbCommand

属性

RequiresDynamicCodeAttribute

实现

IDbCommand ICloneable IDisposable

示例

以下示例使用 OleDbCommandAccess 数据库中的行OleDbDataAdapterOleDbConnection和行。 然后返回填充 DataSet 。 该示例传递了一个已 DataSet初始化的连接字符串、一个连接字符串、一个查询字符串（SQL SELECT 语句）和一个字符串，该字符串是源数据库表的名称。

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

注解

创建实例 OleDbCommand 时，读/写属性将设置为其初始值。 有关这些值的列表，请参阅 OleDbCommand 构造函数。

OleDbCommand 在数据源中执行命令的功能如下：

项目	描述
ExecuteReader	执行返回行的命令。 ExecuteReader 如果用于执行 SQL SET 语句等命令，则可能无法产生所需的效果。
ExecuteNonQuery	执行 SQL INSERT、DELETE、UPDATE 和 SET 语句等命令。
ExecuteScalar	检索单个值，例如数据库中的聚合值。

可以重置 CommandText 属性并重复使用 OleDbCommand 该对象。 但是，必须先关闭该命令 OleDbDataReader ，然后才能执行新的或以前的命令。

如果一个致命 OleDbException 的（例如，SQL Server 严重级别为 20 或更高版本）由执行 a OleDbCommand的方法生成， OleDbConnection则连接可能会关闭。 但是，用户可以重新打开连接并继续。

构造函数

名称	说明
OleDbCommand()	初始化 OleDbCommand 类的新实例。
OleDbCommand(String, OleDbConnection, OleDbTransaction)	使用查询文本、查询文本和 <a0/a0> 初始化类的新实例。
OleDbCommand(String, OleDbConnection)	使用查询文本和查询OleDbConnection文本初始化类的新实例OleDbCommand。
OleDbCommand(String)	使用查询的文本初始化类的新实例 OleDbCommand 。

属性

名称	说明
CommandText	获取或设置在数据源中执行的 SQL 语句或存储过程。
CommandTimeout	获取或设置在终止尝试执行命令并生成错误之前（以秒为单位）的等待时间。
CommandType	获取或设置一个值，该值指示如何 CommandText 解释属性。
Connection	获取或设置 OleDbConnection 此实例 OleDbCommand所使用的 。
DesignTimeVisible	获取或设置一个值，该值指示命令对象是否应在自定义的 Windows 窗体设计器控件中可见。
Parameters	获取 OleDbParameterCollection。
Transaction	获取或设置 OleDbTransaction 执行范围 OleDbCommand 。
UpdatedRowSource	获取或设置命令结果DataRow应用于方法UpdateOleDbDataAdapter的用法。

方法

名称	说明
Cancel()	尝试取消执行 。OleDbCommand
Clone()	创建一个新 OleDbCommand 对象，该对象是当前实例的副本。
CreateParameter()	创建对象 OleDbParameter 的新实例。
ExecuteNonQuery()	对 Connection 受影响的行数执行 SQL 语句并返回受影响的行数。
ExecuteReader()	发送 CommandText 并 Connection 生成一个 OleDbDataReader。
ExecuteReader(CommandBehavior)	将值发送到Connection其中CommandText一个值，并生成一个OleDbDataReaderCommandBehavior值。
ExecuteScalar()	执行查询，并返回查询返回的结果集中第一行的第一列。 忽略其他列或行。
Prepare()	在数据源上创建命令的已准备（或已编译）版本。
ResetCommandTimeout()	将 CommandTimeout 属性重置为默认值。

显式接口实现

名称	说明
ICloneable.Clone()	有关此成员的说明，请参阅 Clone()。
IDbCommand.ExecuteReader()	有关此成员的说明，请参阅 ExecuteReader()。
IDbCommand.ExecuteReader(CommandBehavior)	对Connection值CommandText执行并生成一个IDataReaderCommandBehavior值。

另请参阅

• OleDbDataAdapter
• OleDbConnection
• 使用命令