OracleCommand.ExecuteReader Method (CommandBehavior)

 
System_CAPS_noteNote

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 OracleDataReader using one of the CommandBehavior values.

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

Public Function ExecuteReader (
	behavior As CommandBehavior
) As OracleDataReader

Parameters

behavior
Type: System.Data.CommandBehavior

One of the CommandBehavior values.

If you expect your SQL statement to return only a single row, specifying SingleRow as the CommandBehavior value may 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 then executes this stored procedure when you call ExecuteReader.

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

More than one OracleDataReader can be open at any given time.

The following example creates an OracleCommand, and then executes it by passing a string that is an SQL SELECT statement, and a string to use to connect to the database. CommandBehavior is then set to CloseConnection.

Public Sub CreateMyOracleDataReader(ByVal queryString As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString, connection)
        connection.Open()

        'Implicitly closes the connection because  
        ' CommandBehavior.CloseConnectionwas specified.
        Dim reader As OracleDataReader = _
            command.ExecuteReader(CommandBehavior.CloseConnection)
        While reader.Read()
            Console.WriteLine(reader.GetValue(0))
        End While
        reader.Close()
    End Using
End Sub

.NET Framework
Available since 1.1
Return to top
Show: