OleDbCommand.ExecuteReader 方法

定义

命名空间:

System.Data.OleDb

程序集:

System.Data.OleDb.dll

包:

System.Data.OleDb v9.0.0-preview.3.24172.9

将 CommandText 发送到 Connection 并生成一个 OleDbDataReader。

重载

ExecuteReader()	将 CommandText 发送到 Connection 并生成一个 OleDbDataReader。
ExecuteReader(CommandBehavior)	将 CommandText 发送到 Connection，并使用 CommandBehavior 值之一构造 OleDbDataReader。

ExecuteReader()

Source:

OleDbCommand.cs

将 CommandText 发送到 Connection 并生成一个 OleDbDataReader。

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();

public System.Data.OleDb.OleDbDataReader ExecuteReader ();

override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader () As OleDbDataReader

返回

OleDbDataReader

一个 OleDbDataReader 对象。

例外

InvalidOperationException

不能在连接最初在其中登记的上下文之外的事务上下文中执行命令。

示例

以下示例创建 一个 OleDbCommand，然后通过传递一个 SQL SELECT 语句的字符串和一个用于连接到数据源的字符串来执行它。

public void CreateReader(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub CreateReader(ByVal connectionString As String, _
    ByVal queryString As String)

    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(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

注解

当 属性 CommandType 设置为 StoredProcedure时，应将 CommandText 属性设置为存储过程的名称。 调用 ExecuteReader时，命令将执行此存储过程。

在关闭 之前， OleDbConnection请先关闭 OleDbDataReader 对象。 如果计划重用OleDbCommand对象，OleDbDataReader还必须关闭该对象。

另请参阅

• 使用命令

ExecuteReader(CommandBehavior)

Source:

OleDbCommand.cs

将 CommandText 发送到 Connection，并使用 CommandBehavior 值之一构造 OleDbDataReader。

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.OleDb.OleDbDataReader ExecuteReader (System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

参数

behavior

CommandBehavior

CommandBehavior 值之一。

返回

OleDbDataReader

一个 OleDbDataReader 对象。

例外

InvalidOperationException

不能在连接最初在其中登记的上下文之外的事务上下文中执行命令。

示例

以下示例创建一个 OleDbCommand，然后通过传递一个作为 Transact-SQL SELECT 语句的字符串和一个用于连接到数据源的字符串来执行它。 将 CommandBehavior 设置为 CloseConnection。

public void CreateMyOleDbDataReader(string queryString,string connectionString)
{
   OleDbConnection connection = new OleDbConnection(connectionString);
   OleDbCommand command = new OleDbCommand(queryString, connection);
   connection.Open();
   OleDbDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);
   while(reader.Read())
   {
      Console.WriteLine(reader.GetString(0));
   }
   reader.Close();
   //Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
}

Public Sub CreateMyOleDbDataReader(queryString As String, _
    connectionString As String)
    Dim connection As New OleDbConnection(connectionString)
    Dim command As New OleDbCommand(queryString, connection)
    connection.Open()
    Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
    While reader.Read()
        Console.WriteLine(reader.GetString(0))
    End While
    reader.Close()
    'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
 End Sub

注解

使用 ExecuteReader 对象的 方法OleDbCommand指定SingleRow时，OLE DB .NET Framework数据提供程序使用 OLE DB IRow 接口（如果可用）执行绑定。 否则，它将使用 IRowset 接口。 如果期望 SQL 语句仅返回一行，则指定 SingleRow 也可提高应用程序性能。

当 属性 CommandType 设置为 StoredProcedure时，应将 CommandText 属性设置为存储过程的名称。 调用 ExecuteReader时，命令将执行此存储过程。

支持 OleDbDataReader 一种特殊模式，使大型二进制值能够高效读取。 有关详细信息， SequentialAccess 请参阅 的设置 CommandBehavior。

在关闭 之前， OleDbConnection请先关闭 OleDbDataReader 对象。 如果计划重用OleDbCommand对象，OleDbDataReader还必须关闭该对象。 OleDbDataReader如果创建的 CommandBehavior 设置为 CloseConnection，则关闭 OleDbDataReader 将自动关闭连接。

另请参阅

• 使用命令