Compartilhar via


Método SqlCeCommand.ExecuteReader (CommandBehavior)

Envia CommandText a Connection e cria SqlCeDataReader usando um dos valores de CommandBehavior.

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Function ExecuteReader ( _
    behavior As CommandBehavior _
) As SqlCeDataReader
'Uso
Dim instance As SqlCeCommand
Dim behavior As CommandBehavior
Dim returnValue As SqlCeDataReader

returnValue = instance.ExecuteReader(behavior)
public SqlCeDataReader ExecuteReader(
    CommandBehavior behavior
)
public:
SqlCeDataReader^ ExecuteReader(
    CommandBehavior behavior
)
member ExecuteReader : 
        behavior:CommandBehavior -> SqlCeDataReader 
public function ExecuteReader(
    behavior : CommandBehavior
) : SqlCeDataReader

Parâmetros

Valor de retorno

Tipo: System.Data.SqlServerCe.SqlCeDataReader
Um objeto SqlCeDataReader.

Exceções

Exceção Condição
InvalidOperationException

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

Comentários

O SqlCeDataReader dá suporte a um modo especial que permite a leitura eficiente de valores binários grandes. Para obter mais informações, consulte a configuração SequentialAccess para CommandBehavior.

Enquanto o SqlCeDataReader está sendo usado, a SqlCeConnection associada está ocupada atendendo o SqlCeDataReader. Neste estado, antes de chamar o método Close do SqlCeDataReader, você pode executar apenas a operação Close na SqlCeConnection.

Exemplos

O exemplo a seguir cria um SqlCeCommand e o executa passando uma instrução SQL SELECT e um objeto SqlCeConnection. O CommandBehavior é definido como CloseConnection.

Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand("SELECT * FROM myTable", conn)

cmd.Connection.Open()
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Execute the reader; make sure you alway close the 
    ' reader after you're done using it (ideally in the finally block)
    '
    rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection)

    While rdr.Read()
        Console.WriteLine(rdr.GetString(0))
    End While
Finally
    ' Closing the reader will also close the associated connection
    '
    rdr.Close()
End Try
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand("SELECT * FROM myTable", conn);

cmd.Connection.Open();
SqlCeDataReader rdr = null;

try
{
    // Execute the reader; make sure you alway close the 
    // reader after you're done using it (ideally in the finally block)
    //
    rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection);

    while (rdr.Read())
    {
        Console.WriteLine(rdr.GetString(0));
    }
}
finally
{
    // Closing the reader will also close the associated connection
    //
    rdr.Close();
}

Consulte também

Referência

SqlCeCommand Classe

Sobrecarregado ExecuteReader

Namespace System.Data.SqlServerCe