OleDbCommand.ExecuteReader Methode

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();

public System.Data.OleDb.OleDbDataReader ExecuteReader();

member this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader () As OleDbDataReader

Retouren

Een OleDbDataReader object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een OleDbCommand, en vervolgens uitgevoerd door een tekenreeks door te geven die een SQL SELECT-instructie is en een tekenreeks die moet worden gebruikt om verbinding te maken met de gegevensbron.

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

Opmerkingen

Wanneer de CommandType eigenschap is ingesteld op StoredProcedure, moet de CommandText eigenschap worden ingesteld op de naam van de opgeslagen procedure. Met de opdracht wordt deze opgeslagen procedure uitgevoerd wanneer u aanroept ExecuteReader.

Voordat u het OleDbConnectionobject sluit, sluit u eerst het OleDbDataReader object. U moet het OleDbDataReader object ook sluiten als u van plan bent een OleDbCommand object opnieuw te gebruiken.

Zie ook

• Werken met opdrachten

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.OleDb.OleDbDataReader ExecuteReader(System.Data.CommandBehavior behavior);

member this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Parameters

Retouren

Een OleDbDataReader object.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een OleDbCommand gemaakt en vervolgens uitgevoerd door een tekenreeks door te geven die een Transact-SQL SELECT-instructie is en een tekenreeks die moet worden gebruikt om verbinding te maken met de gegevensbron. CommandBehavior is ingesteld op 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

Opmerkingen

Wanneer u SingleRow opgeeft met de methode ExecuteReader van het object OleDbCommand, voert de .NET Framework-Data Provider voor OLE DB binding uit met behulp van de OLE DB-IRow interface als deze beschikbaar is. Anders wordt de IRowset-interface gebruikt. Als uw SQL-instructie naar verwachting slechts één rij retourneert SingleRow , kan het opgeven ook de prestaties van de toepassing verbeteren.

Wanneer de CommandType eigenschap is ingesteld op StoredProcedure, moet de CommandText eigenschap worden ingesteld op de naam van de opgeslagen procedure. Met de opdracht wordt deze opgeslagen procedure uitgevoerd wanneer u aanroept ExecuteReader.

De OleDbDataReader ondersteuning biedt ondersteuning voor een speciale modus waarmee grote binaire waarden efficiënt kunnen worden gelezen. Zie voor meer informatie de SequentialAccess instelling voor CommandBehavior.

Voordat u het OleDbConnectionobject sluit, sluit u eerst het OleDbDataReader object. U moet het OleDbDataReader object ook sluiten als u van plan bent een OleDbCommand object opnieuw te gebruiken. Als de verbinding OleDbDataReader is gemaakt met CommandBehavior ingesteld op CloseConnection, sluit u de OleDbDataReader verbinding automatisch.

Zie ook

• Werken met opdrachten