OleDbCommand.ExecuteReader Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-rc.2.24473.5

Envia o CommandText para o Connection e cria um OleDbDataReader.

Sobrecargas

ExecuteReader()	Envia o CommandText para o Connection e cria um OleDbDataReader.
ExecuteReader(CommandBehavior)	Envia o CommandText para o Connection e cria um OleDbDataReader usando um dos valores CommandBehavior.

ExecuteReader()

Origem:

OleDbCommand.cs

Envia o CommandText para o Connection e cria um OleDbDataReader.

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

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

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

Public Function ExecuteReader () As OleDbDataReader

Retornos

OleDbDataReader

Um objeto OleDbDataReader.

Exceções

InvalidOperationException

Não é possível executar um comando em um contexto de transação diferente do contexto no qual a conexão foi inscrita originalmente.

Exemplos

O exemplo a seguir cria um OleDbCommande 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 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

Comentários

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

Antes de fechar o OleDbConnection, primeiro feche o OleDbDataReader objeto . Você também deve fechar o OleDbDataReader objeto se planeja reutilizar um OleDbCommand objeto.

Confira também

• Trabalhando com comandos

ExecuteReader(CommandBehavior)

Origem:

OleDbCommand.cs

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

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

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

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

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Parâmetros

behavior

CommandBehavior

Um dos valores de CommandBehavior.

Retornos

OleDbDataReader

Um objeto OleDbDataReader.

Exceções

InvalidOperationException

Não é possível executar um comando em um contexto de transação diferente do contexto no qual a conexão foi inscrita originalmente.

Exemplos

O exemplo a seguir cria um OleDbCommande o executa passando uma cadeia de caracteres que é uma instrução SELECT Transact-SQL e uma cadeia de caracteres a ser usada para se conectar à fonte de dados. CommandBehavior é 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

Comentários

Quando você especifica SingleRow com o ExecuteReader método do OleDbCommand objeto , o provedor de dados .NET Framework para OLE DB executa a associação usando a interface OLE DB IRow se ela estiver disponível. Caso contrário, ele usa a interface IRowset . Se a instrução SQL dever retornar apenas uma única linha, especificar SingleRow também poderá melhorar o desempenho do aplicativo.

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

O OleDbDataReader 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.

Antes de fechar o OleDbConnection, primeiro feche o OleDbDataReader objeto . Você também deve fechar o OleDbDataReader objeto se planeja reutilizar um OleDbCommand objeto. Se o OleDbDataReader for criado com definido CloseConnectioncomo CommandBehavior , fechar o OleDbDataReader fechará a conexão automaticamente.

Confira também

• Trabalhando com comandos