OleDbCommand.ExecuteReader Methode

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paket:

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

Sendet den CommandText an die Connection und erstellt einen OleDbDataReader.

Überlädt

ExecuteReader()	Sendet den CommandText an die Connection und erstellt einen OleDbDataReader.
ExecuteReader(CommandBehavior)	Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OleDbDataReader.

ExecuteReader()

Quelle:

OleDbCommand.cs

Sendet den CommandText an die Connection und erstellt einen 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

Gibt zurück

OleDbDataReader

Ein OleDbDataReader-Objekt.

Ausnahmen

InvalidOperationException

Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.

Beispiele

Im folgenden Beispiel wird ein OleDbCommanderstellt und anschließend ausgeführt, indem eine Zeichenfolge übergeben wird, bei der es sich um eine SQL SELECT-Anweisung handelt, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll.

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

Hinweise

Wenn die CommandType -Eigenschaft auf StoredProcedurefestgelegt ist, sollte die CommandText -Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden. Der Befehl führt diese gespeicherte Prozedur aus, wenn Sie aufrufen ExecuteReader.

Bevor Sie schließen, OleDbConnectionschließen Sie zuerst das OleDbDataReader -Objekt. Sie müssen das OleDbDataReader Objekt auch schließen, wenn Sie planen, ein Objekt wiederzuverwenden OleDbCommand .

Weitere Informationen

• Arbeiten mit Befehlen

ExecuteReader(CommandBehavior)

Quelle:

OleDbCommand.cs

Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen 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

Parameter

behavior

CommandBehavior

Einer der CommandBehavior-Werte.

Gibt zurück

OleDbDataReader

Ein OleDbDataReader-Objekt.

Ausnahmen

InvalidOperationException

Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.

Beispiele

Im folgenden Beispiel wird ein OleDbCommanderstellt und anschließend ausgeführt, indem eine Zeichenfolge übergeben wird, bei der es sich um eine Transact-SQL SELECT-Anweisung handelt, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll. Für CommandBehavior ist CloseConnection festgelegt.

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

Hinweise

Wenn Sie mit der ExecuteReader -Methode des OleDbCommand -Objekts angebenSingleRow, führt der .NET Framework-Datenanbieter für OLE DB die Bindung mithilfe der OLE DB-IRow-Schnittstelle durch, sofern diese verfügbar ist. Andernfalls wird die IRowset-Schnittstelle verwendet. Wenn die SQL-Anweisung nur eine einzige Zeile zurückgeben soll, kann durch Angeben von SingleRow auch die Leistung der Anwendung verbessert werden.

Wenn die CommandType -Eigenschaft auf StoredProcedurefestgelegt ist, sollte die CommandText -Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden. Der Befehl führt diese gespeicherte Prozedur aus, wenn Sie aufrufen ExecuteReader.

Unterstützt OleDbDataReader einen speziellen Modus, mit dem große Binärwerte effizient gelesen werden können. Weitere Informationen finden Sie in der SequentialAccess Einstellung für CommandBehavior.

Bevor Sie schließen, OleDbConnectionschließen Sie zuerst das OleDbDataReader -Objekt. Sie müssen das OleDbDataReader Objekt auch schließen, wenn Sie planen, ein Objekt wiederzuverwenden OleDbCommand . Wenn erstellt OleDbDataReader wird und CommandBehavior auf CloseConnectionfestgelegt ist, wird die OleDbDataReader Verbindung automatisch geschlossen.

Weitere Informationen

• Arbeiten mit Befehlen