OleDbCommand.ExecuteReader Método

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

Devoluções

Um OleDbDataReader objeto.

Exceções

Exemplos

O exemplo seguinte cria um OleDbCommand, e depois executa-o passando uma string que é uma instrução SQL SELECT e uma string para usar para se ligar à fonte de dados.

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

Observações

Quando a CommandType propriedade é definida para StoredProcedure, deve ser CommandText definida como o nome do procedimento armazenado. O comando executa este procedimento armazenado quando chama ExecuteReader.

Antes de fechar o OleDbConnection, primeiro feche o OleDbDataReader objeto. Também deve fechar o OleDbDataReader objeto se planeia reutilizar um OleDbCommand objeto.

Ver também

• Trabalhar com Comandos

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

Parâmetros

Devoluções

Um OleDbDataReader objeto.

Exceções

Exemplos

O exemplo seguinte cria um OleDbCommand e depois executa-o passando uma string que é uma instrução Transact-SQL SELECT e uma string para usar para ligar à fonte de dados. CommandBehavior está definido como 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

Observações

Quando especifica SingleRow com o método ExecuteReader do objeto OleDbCommand, a Data Provider do .NET Framework para OLE DB realiza binding usando a interface OLE DB IRow se estiver disponível. Caso contrário, utiliza a interface IRowset . Se a sua instrução SQL for esperada para devolver apenas uma linha, especificar SingleRow também pode melhorar o desempenho da aplicação.

Quando a CommandType propriedade é definida para StoredProcedure, deve ser CommandText definida como o nome do procedimento armazenado. O comando executa este procedimento armazenado quando chama ExecuteReader.

Suporta OleDbDataReader um modo especial que permite a leitura eficiente de grandes valores binários. Para mais informações, consulte a SequentialAccess definição para CommandBehavior.

Antes de fechar o OleDbConnection, primeiro feche o OleDbDataReader objeto. Também deve fechar o OleDbDataReader objeto se planeia reutilizar um OleDbCommand objeto. Se o OleDbDataReader for criado com CommandBehavior definido para CloseConnection, fechar o OleDbDataReader fecha automaticamente a ligação.

Ver também

• Trabalhar com Comandos