Partilhar via


OracleCommand.ExecuteReader Método

Definição

Envia o CommandText para o Connection e cria um OracleDataReader.

Sobrecargas

ExecuteReader()

Envia o CommandText para o Connection e cria um OracleDataReader.

ExecuteReader(CommandBehavior)

Envia o CommandText para o Connection e cria um OracleDataReader usando um dos valores CommandBehavior.

ExecuteReader()

Envia o CommandText para o Connection e cria um OracleDataReader.

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

Retornos

Um objeto OracleDataReader.

Exemplos

O exemplo a seguir cria um OracleCommande o executa passando uma cadeia de caracteres que é uma instrução SQL SELECT e uma cadeia de caracteres a ser usada para se conectar à fonte de dados.

public void CreateMyOracleDataReader(string queryString, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(reader.GetValue(0));
            }
        }
        finally
        {
            reader.Close();
        }
    }
}
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()
        Dim reader As OracleDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(reader.GetValue(0))
            End While
        Finally
            reader.Close()
        End Try
    End Using
End Sub

Comentários

Quando a CommandType propriedade é definida como StoredProcedure, a CommandText propriedade deve ser definida como o nome do procedimento armazenado. Em seguida, o comando executa esse procedimento armazenado quando você chama ExecuteReader.

Mais de um OracleDataReader pode ser aberto a qualquer momento.

Confira também

Aplica-se a

ExecuteReader(CommandBehavior)

Envia o CommandText para o Connection e cria um OracleDataReader usando um dos valores CommandBehavior.

public:
 System::Data::OracleClient::OracleDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);
public System.Data.OracleClient.OracleDataReader ExecuteReader (System.Data.CommandBehavior behavior);
member this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OracleClient.OracleDataReader
override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OracleClient.OracleDataReader
Public Function ExecuteReader (behavior As CommandBehavior) As OracleDataReader

Parâmetros

behavior
CommandBehavior

Um dos valores de CommandBehavior.

Retornos

Um objeto OracleDataReader.

Exemplos

O exemplo a seguir cria um OracleCommande o executa passando uma cadeia de caracteres que é uma instrução SQL SELECT e uma cadeia de caracteres a ser usada para se conectar ao banco de dados. CommandBehavior em seguida, é definido como CloseConnection.

public void CreateMyOracleDataReader(string queryString, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();

        // Implicitly closes the connection because
        // CommandBehavior.CloseConnection is specified.
        OracleDataReader reader =
            command.ExecuteReader(CommandBehavior.CloseConnection);
        while (reader.Read())
        {
            Console.WriteLine(reader.GetValue(0));
        }
        reader.Close();
    }
}
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

Comentários

Se você espera que sua instrução SQL retorne apenas uma única linha, especificar SingleRow como o valor pode melhorar o desempenho do CommandBehavior aplicativo.

Quando a CommandType propriedade é definida como StoredProcedure, a CommandText propriedade deve ser definida como o nome do procedimento armazenado. Em seguida, o comando executa esse procedimento armazenado quando você chama ExecuteReader.

O OracleDataReader dá suporte a um modo especial que permite que valores binários grandes sejam lidos com eficiência. Para obter mais informações, consulte a SequentialAccess configuração para CommandBehavior.

Mais de um OracleDataReader pode ser aberto a qualquer momento.

Confira também

Aplica-se a