SqlCommand.ExecuteReader Método

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Envia o CommandText para o Connection e cria um SqlDataReader.

Sobrecargas

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

ExecuteReader()

Envia o CommandText para o Connection e cria um SqlDataReader.

public:
 System::Data::SqlClient::SqlDataReader ^ ExecuteReader();

public System.Data.SqlClient.SqlDataReader ExecuteReader ();

override this.ExecuteReader : unit -> System.Data.SqlClient.SqlDataReader

Public Function ExecuteReader () As SqlDataReader

Retornos

SqlDataReader

Um objeto SqlDataReader.

Exceções

InvalidCastException

Um SqlDbType diferente de Binary ou VarBinary foi usado quando Value foi definido Streamcomo . Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

- ou -

Um SqlDbType diferente de Char, NChar, NVarChar, VarChar ou Xml foi usado quando foi definido TextReadercomo Value .

- ou -

Um SqlDbType diferente de Xml foi usado quando Value foi definido como XmlReader.

SqlException

Exceção ao executar o comando em uma linha bloqueada. Essa exceção não é gerada quando o Microsoft .NET Framework versão 1.0 é utilizado.

- ou -

Ocorreu um tempo limite durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

InvalidOperationException

O estado atual da conexão está fechado. ExecuteReader() exige um SqlConnection aberto.

- ou -

O SqlConnection foi fechado ou removido durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

IOException

Ocorreu um erro em um objeto Stream, XmlReader ou TextReader durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

ObjectDisposedException

O objeto Stream, XmlReader ou TextReader foi fechado durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

Exemplos

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

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        connection.Open();

        SqlCommand command = new SqlCommand(queryString, connection);
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()

        Dim command As New SqlCommand(queryString, connection)
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine("{0}", reader(0))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Comentários

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

Observação

Se uma transação estiver em deadlock, uma exceção poderá não ser gerada até Read que seja chamada.

O recurso MARS (conjunto de resultados ativo múltiplo) permite várias ações usando a mesma conexão.

Se você usar ExecuteReader ou BeginExecuteReader para acessar dados XML, SQL Server retornará resultados XML maiores que 2.033 caracteres de comprimento em várias linhas de 2.033 caracteres cada. Para evitar esse comportamento, use ExecuteXmlReader ou BeginExecuteXmlReader para ler consultas FOR XML.

Confira também

• Recuperando e modificando dados no ADO.NET
• SQL Server e ADO.NET
• Visão geral do ADO.NET

ExecuteReader(CommandBehavior)

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

public:
 System::Data::SqlClient::SqlDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.SqlClient.SqlDataReader ExecuteReader (System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.SqlClient.SqlDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As SqlDataReader

Parâmetros

behavior

CommandBehavior

Um dos valores de CommandBehavior.

Retornos

SqlDataReader

Um objeto SqlDataReader.

Exceções

InvalidCastException

Um SqlDbType diferente de Binary ou VarBinary foi usado quando Value foi definido Streamcomo . Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

- ou -

Um SqlDbType diferente de Char, NChar, NVarChar, VarChar ou Xml foi usado quando foi definido TextReadercomo Value .

- ou -

Um SqlDbType diferente de Xml foi usado quando Value foi definido como XmlReader.

SqlException

Ocorreu um tempo limite durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

IOException

Ocorreu um erro em um objeto Stream, XmlReader ou TextReader durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

InvalidOperationException

O SqlConnection foi fechado ou removido durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

ObjectDisposedException

O objeto Stream, XmlReader ou TextReader foi fechado durante uma operação de streaming. Para saber mais sobre o streaming, consulte SqlClient Streaming Support (Suporte de streaming do SqlClient).

Exemplos

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

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        connection.Open();
        using(SqlDataReader reader =
            command.ExecuteReader(CommandBehavior.CloseConnection))
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = _
            command.ExecuteReader(CommandBehavior.CloseConnection)
        Try
            While reader.Read()
                Console.WriteLine("{0}", reader(0))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Comentários

Quando a CommandType propriedade é definida StoredProcedurecomo , 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 poderá ocorrer e a conexão será fechada.

O recurso MARS (conjunto de resultados ativo múltiplo) permite várias ações usando a mesma conexão.

Se você usar ExecuteReader ou BeginExecuteReader para acessar dados XML, SQL Server retornará resultados XML maiores que 2.033 caracteres de comprimento em várias linhas de 2.033 caracteres cada. Para evitar esse comportamento, use ExecuteXmlReader ou BeginExecuteXmlReader para ler consultas FOR XML.

Confira também

• Conectando e recuperando dados em ADO.NET
• Usando o provedor de dados .NET Framework para SQL Server
• Visão geral do ADO.NET