OleDbCommand.ExecuteReader 方法

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

System.Data.OleDb v9.0.0-rc.2.24473.5

傳送 CommandText 至 Connection，並建置 OleDbDataReader。

多載

ExecuteReader()	傳送 CommandText 至 Connection，並建置 OleDbDataReader。
ExecuteReader(CommandBehavior)	傳送 CommandText 至 Connection，並使用其中一個 CommandBehavior 值來建立 OleDbDataReader。

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

另請參閱

• 使用命令

ExecuteReader(CommandBehavior)

來源:

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時，.NET Framework Data Provider for OLE DB 會在可以使用時，使用 OLE DB IRow 介面執行系結。 否則，它會使用 IRowset 介面。 如果 SQL 陳述式預期只會傳回單一資料列，則指定 SingleRow 也可以增進應用程式效能。

CommandType當屬性設定為 StoredProcedure時，CommandText屬性應該設定為預存程序的名稱。 當您呼叫 ExecuteReader時，此命令會執行這個預存程式。

OleDbDataReader支援特殊模式，讓大型二進位值有效率地讀取。 如需詳細資訊，請參閱 SequentialAccess 的 CommandBehavior設定。

在您關閉 OleDbConnection之前，請先關閉 OleDbDataReader 物件。 如果您打算重複使用OleDbCommand物件，OleDbDataReader您也必須關閉物件。 OleDbDataReader如果 建立 時CommandBehavior設定為 CloseConnection，則關閉會自動OleDbDataReader關閉連線。

另請參閱

• 使用命令