OleDbCommand.ExecuteReader OleDbCommand.ExecuteReader OleDbCommand.ExecuteReader OleDbCommand.ExecuteReader Method

Definition

Sendet den CommandText an die Connection und erstellt einen OleDbDataReader.Sends the CommandText to the Connection and builds an OleDbDataReader.

Überlädt

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Sendet den CommandText an die Connection und erstellt einen OleDbDataReader.Sends the CommandText to the Connection and builds an OleDbDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OleDbDataReader.Sends the CommandText to the Connection, and builds an OleDbDataReader using one of the CommandBehavior values.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Sendet den CommandText an die Connection und erstellt einen OleDbDataReader.Sends the CommandText to the Connection and builds an 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

Ausnahmen

Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Beispiele

Im folgenden Beispiel wird ein OleDbCommanderstellt und dann ausgeführt, indem eine Zeichenfolge, die eine SQL-SELECT-Anweisung ist, und eine Zeichenfolge übergeben wird, mit der eine Verbindung mit der Datenquelle hergestellt wird.The following example creates an OleDbCommand, and then executes it by passing a string that is an SQL SELECT statement, and a string to use to connect to the data source.

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 CommandText , sollte die-Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden.When the CommandType property is set to StoredProcedure, the CommandText property should be set to the name of the stored procedure. Der-Befehl führt diese gespeicherte Prozedur aus, ExecuteReaderwenn aufgerufen wird.The command executes this stored procedure when you call ExecuteReader.

Bevor Sie schließen OleDbConnection, schließen Sie zuerst das OleDbDataReader -Objekt.Before you close the OleDbConnection, first close the OleDbDataReader object. Sie müssen das OleDbDataReader -Objekt auch schließen, wenn Sie ein OleDbCommand Objekt wieder verwenden möchten.You must also close the OleDbDataReader object if you plan to reuse an OleDbCommand object.

Siehe auch

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OleDbDataReader.Sends the CommandText to the Connection, and builds an OleDbDataReader using one of the CommandBehavior values.

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

Gibt zurück

Ausnahmen

Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Beispiele

Im folgenden Beispiel wird ein OleDbCommanderstellt und dann ausgeführt, indem eine Zeichenfolge, die eine SELECT-Anweisung von Transact-SQL ist, und eine Zeichenfolge übergeben wird, mit der eine Verbindung mit der Datenquelle hergestellt wird.The following example creates an OleDbCommand, and then executes it by passing a string that is a Transact-SQL SELECT statement, and a string to use to connect to the data source. Für CommandBehavior ist CloseConnection festgelegt.CommandBehavior is set to 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

Hinweise

Wenn Sie mit SingleRow der ExecuteReader -Methode des OleDbCommand -Objekts angeben, führt die .NET Framework Datenanbieter für OLE DB eine Bindung mithilfe der OLE DB IRow -Schnittstelle aus, sofern diese verfügbar ist.When you specify SingleRow with the ExecuteReader method of the OleDbCommand object, the .NET Framework Data Provider for OLE DB performs binding using the OLE DB IRow interface if it is available. Andernfalls wird die IRowset -Schnittstelle verwendet.Otherwise, it uses the IRowset interface. Wenn die SQL-Anweisung nur eine einzige Zeile zurückgeben soll, kann durch Angeben von SingleRow auch die Leistung der Anwendung verbessert werden.If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance.

Wenn die CommandType -Eigenschaft auf StoredProcedurefestgelegt ist CommandText , sollte die-Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden.When the CommandType property is set to StoredProcedure, the CommandText property should be set to the name of the stored procedure. Der-Befehl führt diese gespeicherte Prozedur aus, ExecuteReaderwenn aufgerufen wird.The command executes this stored procedure when you call ExecuteReader.

Unter OleDbDataReader stützt einen speziellen Modus, der das effiziente Lesen großer Binär Werte ermöglicht.The OleDbDataReader supports a special mode that enables large binary values to be read efficiently. Weitere Informationen finden Sie unter der SequentialAccess -Einstellung CommandBehaviorfür.For more information, see the SequentialAccess setting for CommandBehavior.

Bevor Sie schließen OleDbConnection, schließen Sie zuerst das OleDbDataReader -Objekt.Before you close the OleDbConnection, first close the OleDbDataReader object. Sie müssen das OleDbDataReader -Objekt auch schließen, wenn Sie ein OleDbCommand Objekt wieder verwenden möchten.You must also close the OleDbDataReader object if you plan to reuse an OleDbCommand object. Wenn erstellt CommandBehavior CloseConnectionwird,wobei aufOleDbDataReader festgelegt ist, wird die Verbindung geschlossen, wenn geschlossen wird. OleDbDataReaderIf the OleDbDataReader is created with CommandBehavior set to CloseConnection, closing the OleDbDataReader closes the connection automatically.

Siehe auch

Gilt für: