IDbCommand.ExecuteReader Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Executa o CommandText no Connection e compila um IDataReader.

Sobrecargas

ExecuteReader()	Executa o CommandText no Connection e compila um IDataReader.
ExecuteReader(CommandBehavior)	Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior.

ExecuteReader()

Executa o CommandText no Connection e compila um IDataReader.

public:
 System::Data::IDataReader ^ ExecuteReader();

public System.Data.IDataReader ExecuteReader ();

abstract member ExecuteReader : unit -> System.Data.IDataReader

Public Function ExecuteReader () As IDataReader

Retornos

IDataReader

Um objeto IDataReader.

ExecuteReader(CommandBehavior)

Executa o CommandText para o Connection e cria um IDataReader usando um dos valores de CommandBehavior.

public:
 System::Data::IDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.IDataReader ExecuteReader (System.Data.CommandBehavior behavior);

abstract member ExecuteReader : System.Data.CommandBehavior -> System.Data.IDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As IDataReader

Parâmetros

behavior

CommandBehavior

Um dos valores de CommandBehavior.

Retornos

IDataReader

Um objeto IDataReader.

Comentários

O chamador deve chamar o Open método da Connection propriedade .

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.

Observação

Use SequentialAccess para recuperar valores grandes e dados binários. Caso contrário, um OutOfMemoryException pode ocorrer e a conexão será fechada.

Enquanto o IDataReader está em uso, o associado IDbConnection está ocupado atendendo o IDataReader. Nesse estado, nenhuma outra operação pode ser executada além de IDbConnection fechá-la. Esse é o caso até que o Close método do DataReader seja chamado. Se o DataReader for criado com definido CloseConnectioncomo CommandBehavior , fechar o DataReader fechará a conexão automaticamente.