OleDbCommand.ExecuteReader 方法

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v11.0.0-rc.1.26425.128

將 CommandText 傳送到 並 Connection 建立一個 OleDbDataReader。

多載

名稱	Description
ExecuteReader()	將 CommandText 傳送到 並 Connection 建立一個 OleDbDataReader。
ExecuteReader(CommandBehavior)	將 CommandText 傳送到 Connection，並利用其中一個OleDbDataReader值建立 CommandBehavior 。

ExecuteReader()

來源:

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 物件。 如果你打算重複使用物件，OleDbDataReader也必須關閉該OleDbCommand物件。

另請參閱

• 與指令合作

ExecuteReader(CommandBehavior)

來源:

OleDbCommand.cs

將 CommandText 傳送到 Connection，並利用其中一個OleDbDataReader值建立 CommandBehavior 。

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

備註

當你用SingleRow物件的方法ExecuteReader來指定OleDbCommand時，OLE DB 的 .NET Framework 資料提供者會使用 OLE DB IRow 介面（如果有的話）來進行綁定。 否則，它會使用 IRowset 介面。 如果你的 SQL 陳述式預期只會回傳一列，指定 SingleRow 也能提升應用程式效能。

當屬性 CommandType 設定為 StoredProcedure時， CommandText 該屬性應設定為儲存程序的名稱。 當你呼叫 ExecuteReader時，指令會執行這個儲存程序。

它 OleDbDataReader 支援一種特殊模式，使得大二進位值能被有效讀取。 欲了解更多資訊，請參閱 的SequentialAccess設定。CommandBehavior

在你關閉 OleDbConnection之前，先關閉 OleDbDataReader 物件。 如果你打算重複使用物件，OleDbDataReader也必須關閉該OleDbCommand物件。 如果 被 OleDbDataReader 設定 CommandBehavior 為 CloseConnection，則關閉 OleDbDataReader 連接會自動關閉。

另請參閱

• 與指令合作