OleDbCommand.ExecuteReader Método

Origem:

OleDbCommand.cs

Origem:

OleDbCommand.cs

Origem:

OleDbCommand.cs

Origem:

OleDbCommand.cs

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

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

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

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

Public Function ExecuteReader () As OleDbDataReader

Retornos

Um objeto OleDbDataReader.

Exceções

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 este procedimento armazenado quando você chama ExecuteReader.

Antes de fechar o OleDbConnectionobjeto, 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

Origem:

OleDbCommand.cs

Origem:

OleDbCommand.cs

Origem:

OleDbCommand.cs

Origem:

OleDbCommand.cs

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

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

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Parâmetros

Retornos

Um objeto OleDbDataReader.

Exceções

Exemplos

O exemplo a seguir cria um OleDbCommande, em seguida, executa-o passando uma cadeia de caracteres que é uma instrução Transact-SQL SELECT 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 objeto, o Provedor de OleDbCommand Dados do .NET Framework para OLE DB executa a associação usando a interface OLE DB IRow se ela estiver disponível. Caso contrário, ele usará a interface IRowset . Se sua instrução SQL deve retornar apenas uma única linha, a especificação SingleRow também pode 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 este procedimento armazenado quando você chama ExecuteReader.

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

Antes de fechar o OleDbConnectionobjeto, primeiro feche o OleDbDataReader objeto. Você também deve fechar o OleDbDataReader objeto se planeja reutilizar um OleDbCommand objeto. Se o OleDbDataReader valor for criado com CommandBehavior set to CloseConnection, fechar a OleDbDataReader conexão será fechado automaticamente.

Confira também

• Trabalhando com comandos