OleDbCommand.ExecuteReader Method (CommandBehavior)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Sends the CommandText to the Connection, and builds an OleDbDataReader using one of the CommandBehavior values.

Namespace:   System.Data.OleDb
Assembly:  System.Data (in System.Data.dll)

Public Function ExecuteReader (
	behavior As CommandBehavior
) As OleDbDataReader


Type: System.Data.CommandBehavior

One of the CommandBehavior values.

Exception Condition

Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

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. Otherwise, it uses the IRowset interface. If your SQL statement is expected to return only a single row, specifying SingleRow can also improve application performance.

When the CommandType property is set to StoredProcedure, the CommandText property should be set to the name of the stored procedure. The command executes this stored procedure when you call ExecuteReader.

The OleDbDataReader supports a special mode that enables large binary values to be read efficiently. For more information, see the SequentialAccess setting for CommandBehavior.

Before you close the OleDbConnection, first close the OleDbDataReader object. You must also close the OleDbDataReader object if you plan to reuse an OleDbCommand object. If the OleDbDataReader is created with CommandBehavior set to CloseConnection, closing the OleDbDataReader closes the connection automatically.

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. CommandBehavior is set to CloseConnection.

Public Sub CreateMyOleDbDataReader(queryString As String, _
    connectionString As String)
    Dim connection As New OleDbConnection(connectionString)
    Dim command As New OleDbCommand(queryString, connection)
    Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
    While reader.Read()
    End While
    'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
 End Sub

.NET Framework
Available since 1.1
Return to top