Freigeben über


OleDbCommand.ExecuteReader Methode

Definition

Sendet die CommandText an und Connection erstellt eine OleDbDataReader.

Überlädt

Name Beschreibung
ExecuteReader()

Sendet die CommandText an und Connection erstellt eine OleDbDataReader.

ExecuteReader(CommandBehavior)

Sendet den CommandText Wert an das ConnectionUnd erstellt einen OleDbDataReader mit einem der CommandBehavior Werte.

ExecuteReader()

Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs

Sendet die CommandText an und Connection erstellt eine OleDbDataReader.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();
public System.Data.OleDb.OleDbDataReader ExecuteReader();
override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
member this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
Public Function ExecuteReader () As OleDbDataReader

Gibt zurück

Ein OleDbDataReader-Objekt.

Ausnahmen

Innerhalb eines Transaktionskontexts kann kein Befehl ausgeführt werden, der sich vom Kontext unterscheidet, in dem die Verbindung ursprünglich aufgelistet wurde.

Beispiele

Im folgenden Beispiel wird ein OleDbCommandZeichenfolge erstellt und anschließend ausgeführt, indem eine Zeichenfolge übergeben wird, die eine SQL SELECT-Anweisung ist, 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" festgelegt 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 das OleDbConnectionObjekt schließen, schließen Sie zuerst das OleDbDataReader Objekt. Sie müssen das OleDbDataReader Objekt auch schließen, wenn Sie beabsichtigen, ein OleDbCommand Objekt wiederzuverwenden.

Weitere Informationen

Gilt für:

ExecuteReader(CommandBehavior)

Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs

Sendet den CommandText Wert an das ConnectionUnd erstellt einen OleDbDataReader mit einem der CommandBehavior Werte.

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
member 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

Ein OleDbDataReader-Objekt.

Ausnahmen

Innerhalb eines Transaktionskontexts kann kein Befehl ausgeführt werden, der sich vom Kontext unterscheidet, in dem die Verbindung ursprünglich aufgelistet wurde.

Beispiele

Im folgenden Beispiel wird ein OleDbCommandZeichenfolge erstellt und anschließend ausgeführt, indem eine Zeichenfolge übergeben wird, die eine Transact-SQL SELECT-Anweisung ist, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll. CommandBehavior ist auf 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 eine Bindung mithilfe der OLE DB IRow-Schnittstelle aus, falls diese verfügbar ist. Andernfalls wird die IRowset-Schnittstelle verwendet. Wenn ihre SQL-Anweisung erwartet wird, dass nur eine einzelne Zeile zurückgegeben wird, kann die Angabe SingleRow auch die Anwendungsleistung verbessern.

Wenn die CommandType Eigenschaft auf " StoredProcedureFestgelegt" festgelegt 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.

Dies OleDbDataReader unterstützt 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 das OleDbConnectionObjekt schließen, schließen Sie zuerst das OleDbDataReader Objekt. Sie müssen das OleDbDataReader Objekt auch schließen, wenn Sie beabsichtigen, ein OleDbCommand Objekt wiederzuverwenden. Wenn die OleDbDataReader Datei mit CommandBehavior festgelegter Einstellung CloseConnectionerstellt wird, wird die OleDbDataReader Verbindung automatisch geschlossen.

Weitere Informationen

Gilt für: