SqlCommand.ExecuteReader Método

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

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

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

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

Public Function ExecuteReader () As SqlDataReader

Retornos

Um objeto SqlDataReader.

Exceções

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.

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

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

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

Public Function ExecuteReader (behavior As CommandBehavior) As SqlDataReader

Parâmetros

Retornos

Um objeto SqlDataReader.

Exceções

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.

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